Minimalist CV is an open-source Astro template that creates a print-friendly resume website from a single TypeScript config file. The project is a rewrite of BartoszJarocki/cv — originally built in Next.js — using Astro to ship zero client-side JavaScript while keeping a clean, minimalist design.
What is Minimalist CV?
Minimalist CV is a static site template built with Astro 5.16, TypeScript 5.0, and Tailwind CSS 4.1. It takes all your resume data from one file — src/data/cv.ts — and renders a responsive, SEO-friendly CV page as pre-built HTML with no client-side JavaScript. The template is released under the MIT License and maintained on GitHub by ZhukDI.
Key Features
- Single Config File — All personal information, work experience, education, and skills live in
src/data/cv.ts; update one file to change the whole resume. - Zero JavaScript by Default — The generated site ships with no client-side JS, so pages load fast and run anywhere static HTML works.
- Print-Optimized Layout — Includes dedicated print styles so the on-screen resume also produces clean physical copies.
- Responsive Design — The layout adapts from mobile to desktop without extra configuration.
- SEO-Friendly Metadata — Built-in metadata optimization for better search visibility.
- Docker-Ready — The project includes a Docker badge, indicating containerized setup is supported.
- Modern Tech Stack — Built on Astro for static generation, TypeScript for type-safe config, and Tailwind CSS for utility-first styling.
Who is it for?
Minimalist CV suits developers, job seekers, and designers who want a code-managed resume that stays consistent across web and print. Developers can maintain their CV in Git and deploy to any static host; job seekers can produce a print-ready PDF directly from the browser; designers get a minimalist canvas with utility-class styling to customize without hunting through complex templates.
What can you do with it?
- Job applications: Fill in
src/data/cv.tsand print the page to PDF for a clean resume to attach to applications. - Personal portfolio site: Deploy the static
dist/output to GitHub Pages, Netlify, or any static server to share your resume online. - Version-controlled CV: Keep your resume data in a Git repository so every change is trackable and you can fork the template for tailored versions.
How does it work?
Start by cloning the repository and running npm install. Then npm run dev starts a local server at localhost:4321. Edit src/data/cv.ts with your details, and the page updates immediately. When you're ready to share, npm run build outputs a production site to ./dist/, which you can preview with npm run preview.
Pros and cons
- Pros: No client-side JavaScript, print styles included, one-file data management, MIT-licensed, Docker-ready.
- Cons: Requires Node.js 22+ to run the local development and build toolchain; customization of layout requires understanding Astro components and Tailwind classes.
Pricing
Minimalist CV is free and open source under the MIT License.
Alternatives
- BartoszJarocki/cv — the original Next.js implementation that inspired this template.
FAQ
Is Minimalist CV free?
Yes, the template is released under the MIT License, so you can use, modify, and distribute it freely, including for commercial purposes.
Do I need to know JavaScript to use it?
The data config, src/data/cv.ts, is plain TypeScript object data, so editing it is straightforward even with limited JavaScript knowledge. Deeper layout changes would require Astro and Tailwind CSS familiarity.
Does the resume print well?
Yes, the template includes specially designed print styles. Using the browser's print function produces a clean physical copy without excess spacing or website chrome.
What Node version is required?
Node.js 22 or higher is listed as a prerequisite for running the dev server and build commands.
Can I deploy this anywhere?
Because the build output is static HTML, you can host it on any static site service such as GitHub Pages, Netlify, or Vercel, or serve it from Docker.
