mmistakes/minimal-mistakes
:triangular_ruler: Jekyll theme for building a personal site, blog, project documentation, or portfolio.
Older snapshot: check the original source for current information.
From the publisher
README & documentation
Source previewRead the project’s overview, installation instructions and usage examples. The original README is the source of truth.
[](https://raw.githubusercontent.com/mmistakes/minimal-mistakes/master/LICENSE) [](https://jekyllrb.com/) 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 :smile:. :sparkles: See what's new in the CHANGELOG. Note: The theme uses the jekyll-include-cache plugin which will need to be installed in your Gemfile and must be retained in the plugins array of config.yml. Otherwise you'll encounter Unknown tag 'includecached' errors at build. ![Minimal Mistakes live preview][1] This theme comes in 11 different skins (in addition to the default one). Additional sample posts are available under posts archive on the demo site. Source files for these (and the entire demo site) can be found in /docs. There are three ways to install: as a gem-based theme, as a remote theme (GitHub Pages compatible), or forking/directly copying all of the theme files into your project. With Gem-based themes,…
Read the full README ↗ · Preview checked 2026-11-01T15:54:28.487Z
Inside the original README — Document outline
- Minimal Mistakes Jekyll theme
- Notable features
- Skins (color variations)
- Demo pages
- Installation
- Gem-based method
- Remote theme method
- Usage
- Contributing
- Pull Requests
- Development
- Credits
Headings are captured from the source. Links open the publisher’s document, not a locally hosted copy.
Links from the README
References supplied by the publisher, not independently verified endorsements. Check the destination before downloading files or entering credentials.
Documentation belongs to its respective authors. Reported project/model license: MIT. A listing is not a grant of reuse or training rights. Confirm the document’s own terms at the source.
What this repository does
:triangular_ruler: Jekyll theme for building a personal site, blog, project documentation, or portfolio.
Repository facts
- Owner
- mmistakes
- Primary language
- HTML
- Stars
- 13,569
- Forks
- 27,194
- Open issues + pull requests
- 22
- License
- MIT
- Archived
- No
- Default branch
- master
- Created
- 2013-05-24T14:13:30.000Z
- Last push
- 2026-09-08T08:19:39.000Z
Topics and intended use
Owner-supplied topics: algolia, algolia-search, github-pages, jekyll, jekyll-theme, lunr, ruby-gem, theme
Review the README for scope, installation, examples and limitations. We do not run repository code or certify it.
Evaluate before installing
Review licensing and dependencies, inspect recent commits and unresolved issues, and test in an isolated environment before production use. Stars and forks alone cannot answer these questions.
Source and freshness
Source: GitHub. Metadata observed 2026-09-17T06:39:48.780Z. Daily imports are snapshots, not real-time monitoring.
Popularity and source listings do not establish security, suitability, licensing rights or benchmark performance.