Minimal Mistakes
Minimal Mistakes is a free, open-source static site theme built with Jekyll. Jekyll theme for building a personal site, blog, project documentation, or portfolio. It has 13,589 GitHub stars and is released under the MIT license. A live demo is linked from this page.
github.com/mmistakes/minimal-mistakes (opens in a new tab)
Data as of from the GitHub API; description from the project's repository. Report an error
Get started
Copy the files into a new folder with degit (no git history), or clone the repository with git.
npx degit mmistakes/minimal-mistakes my-site
cd my-site
bundle install
bundle exec jekyll servegit clone --depth 1 https://github.com/mmistakes/minimal-mistakes.git my-siteSources: GitHub docs on template repositories, degit.
About Minimal Mistakes
Minimal Mistakes is a flexible two-column Jekyll theme, perfect for building personal sites, blogs, and portfolios. As the name implies, styling is purposely minimalistic to be enhanced and customized by you.
Built with
- Jekyll
Similar templates
More static site themes
Hugo PaperMod
adityatelange/hugo-PaperMod
A fast, clean, responsive Hugo theme.
Maintained · last commit Oct 25, 2026
Static site themesHTMLJekyll Theme Chirpy
cotes2020/jekyll-theme-chirpy
A minimal, responsive, and feature-rich Jekyll theme for technical writing.
Active · last commit Sep 6, 2026
Static site themesHTMLal-folio
alshedivat/al-folio
A beautiful, simple, clean, and responsive Jekyll theme for academics.
Active · last commit Oct 26, 2026
Static site themesHTMLJust The Docs
just-the-docs/just-the-docs
A modern, high customizable, responsive Jekyll theme for documentation with built-in search.
Maintained · last commit Oct 26, 2026
OfficialStatic site themesSCSSHugo Theme Documentation
HugoBlox/hugo-theme-documentation
Docs site that builds in ~1s. AI generates pages, you own as Markdown.
Maintained · last commit May 27, 2026
Static site themesHuxpro site
Huxpro/huxpro.github.io
The original Jekyll blog and theme, preserved at huxpro.github.io.
Maintained · last commit Sep 13, 2026
Static site themesHTML
How do I use Minimal Mistakes?
Copy the files into a new folder with npx degit mmistakes/minimal-mistakes my-site (no git history), or fork the repository on GitHub. Then follow the README for the install and dev commands.
Can I use Minimal Mistakes for commercial projects?
Yes. Minimal Mistakes is released under the MIT license, a permissive license that allows commercial use as long as you keep the copyright and license notice. Third-party assets bundled with it (images, fonts, icons) may have their own terms.
Is Minimal Mistakes maintained?
The repository's most recent commit was on Oct 9, 2026. Its latest release is 4.28.1. appsgit only lists templates from repositories with a commit in the last six months.