Material Design CV Template is a single-page, material-design-inspired CV website template that turns a JSON content file into a deployable static HTML page.
What is Material Design CV Template?
Material Design CV Template is an open-source template by Alicia Sykes (2017) for building a one-page resume site in Google's Material Design style. You provide your CV details in a JSON file, and the built output is a minified static HTML document ready to host anywhere. It uses a Node.js toolchain with Gulp, Pug, and Sass to compile the project.
Key Features
- Single-file content editing — All textual content is stored in src/locals.json; if you accept the default layout, it's the only file you need to touch.
- Material design themes — Multiple theme choices are built in, all following the Material Design aesthetic.
- Static output — After yarn build, the dist/ directory contains production-ready static files, including index.html, that can be deployed to any CDN or static host.
- Gulp build pipeline — gulpfile.js orchestrates compilation and minification; yarn build, yarn start, and yarn watch cover build, serve, and auto-rebuild during development.
- Pug and Sass source — Views are authored as Pug HTML fragments, styles as Sass, and interactive behaviors in CoffeeScript, with source compiled into plain HTML/CSS/JS.
- Example configs and live demo — The examples/ folder includes sample config files and screenshots, and a live demo runs at aliciasykes.com/cv.
Who is it for?
- Job seekers — Build a polished single-page CV site by only editing the JSON file, no HTML/CSS coding required.
- Developers — Customize the Pug, Sass, and CoffeeScript source to create a unique resume design or extend the template.
- Self-hosters — Deploy the static dist folder to GitHub Pages, Netlify, or any other static hosting without server-side dependencies.
What can you do with it?
- Career changers — Publish a clean, Material-style resume that presents work history and skills in a scannable single page.
- Students — Quickly assemble a professional CV page for internships, co-op placements, or graduate school applications.
- Freelancers — Link to a custom CV URL from your portfolio or social profiles, and update content by editing one JSON file.
How does it work?
- Clone the repository: git clone https://github.com/Lissy93/md-cv-maker.git
- Install dependencies with yarn install.
- Populate src/locals.json with your resume content (see examples/ for reference).
- Run yarn build to compile and minify the source.
- Open dist/index.html or serve with yarn start. During development, yarn watch rebuilds on changes.
FAQ
Is Material Design CV Template free?
Yes, the template is open source under the MIT license, so you can use, modify, and redistribute it freely.
What files do I need to edit?
For content, only src/locals.json. If you're happy with the default layout, you don't need to touch the Pug, Sass, or CoffeeScript source files.
How do I deploy the CV?
Run yarn build, then upload the contents of the dist/ directory to any static hosting service such as Netlify, GitHub Pages, or an ordinary web server.
Can I customize the theme?
Yes, the template includes several Material Design theme choices. You can also modify the Sass variables or source styles to create your own theme.
