Minimal Mistakes

Last updated on
On this page

Minimal Mistakes is a flexible two-column Jekyll theme. Perfect for hosting your personal site, blog, or portfolio on GitHub or your own server.

Source on GitHub Live demo

Minimal Mistakes splash layout
Splash layout, ideal for landing pages.
Minimal Mistakes posts by year archive layout
Group posts by year with this archive layout.
Minimal Mistakes post layout
A post layout with optional author sidebar and customizable social media links, share buttons, and related posts widget.
Minimal Mistakes post layout with sidebars
Flexible and customizable. Easily add custom navigation and table of contents sidebars to documentation heavy pages.

Features

Includes responsive layouts (single, archive index, search, splash, and paginated home page) that look great on mobile and desktop browsers. As the name implies — styling is purposely minimalistic to be enhanced and customized by you.

GitHub Pages compatibility

Installs as a remote theme for an easier upgrade path. You can also install it as a Ruby gem or fork the repository and use it as a starter template.

Native Sass support

Leverages Jekyll’s built-in Sass/SCSS preprocessor for easier maintenance and customization of the theme’s colors and typography.

Color variations

Comes bundled with nine different “skins”.

Air skin Contrast skin Dark skin
air skin contrast skin dark skin
Dirt skin Mint skin Sunrise skin
dirt skin mint skin sunrise skin
Aqua skin Neon skin Plum skin
aqua skin neon skin plum skin

Commenting

Includes support for the following commenting systems and providers: Disqus, Facebook, Discourse, static-based via Staticman, utterances, and giscus.

Localized user-interface

Includes translated text for all UI used across the theme in a YAML data file. Custom the text for any of the following languages (or add your own): English (default), Arabic (عربي), Brazilian Portuguese (Português brasileiro), Catalan, Chinese, Danish, Dutch, Finnish, French (Français), German (Deutsch), Greek, Hebrew, Hindi (हिंदी), Hungarian, Indonesian, Irish (Gaeilge), Italian (Italiano), Japanese, Korean, Malayalam, Myanmar (Burmese), Nepali (Nepalese), Norwegian (Norsk), Persian (فارسی), Polish, Punjabi (ਪੰਜਾਬੀ), Romanian, Russian, Slovak, Spanish (Español), Swedish, Thai, Turkish (Türkçe), and Vietnamese.

Documentation

To learn more about how to customize this theme, include feature images in posts, modify the look and feel, and create new posts, read up here. Includes sample pages showing off all layouts, components, and more.

Troubleshooting

Need help setting up the theme or getting it configured? Search the discussions or issues on GitHub. Having trouble installing or using Jekyll, the Jekyll Talk forum is a good place to ask for help.

License

This theme is free and open source software, distributed under the MIT License.