# mmistakes/minimal-mistakes

:triangular_ruler: Jekyll theme for building a personal site, blog, project documentation, or portfolio.

Repository: https://github.com/mmistakes/minimal-mistakes
Canonical: https://ross.abutalabs.com/products/minimal-mistakes
Homepage: https://mmistakes.github.io/minimal-mistakes/
Language: HTML
License: MIT
License Family: permissive
Topics: jekyll, jekyll-theme, theme, github-pages, ruby-gem, algolia, algolia-search, lunr
Last push: 2026-08-19T02:36:18+00:00

## Health v2 (maintenance only)
Score: 90/100 (v2, computed 2026-09-03T02:39:23.370411+00:00)
- activity 98, release rhythm 73, longevity 100
- inputs: {"age_days": 4849, "days_push": 15, "days_rel": 23, "gap_med": 92, "n_releases_24m": 6}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 13557, forks 27224 (observed 2026-08-28T04:11:03.541489+00:00)

## What it is
Minimal Mistakes is a flexible two-column Jekyll theme distributed as a Ruby gem, designed for personal sites, blogs, project documentation, and portfolios. It is GitHub Pages compatible and offers responsive layouts, multiple color skins, search integration, SEO support, and extensive customization via YAML front matter.

## Use cases
- build a personal blog with Jekyll
- create a portfolio site hosted on GitHub Pages
- set up project documentation with a table of contents
- start a minimal two-column static website
- add client-side search to a Jekyll blog
- customize a responsive Jekyll theme with different color skins

## When to choose
- you want a GitHub Pages-compatible Jekyll theme for a blog or personal site
- you need responsive layouts with minimal styling you can customize
- you want built-in SEO, commenting, and analytics integrations
- you prefer a theme installable and upgradable as a Ruby gem

## When to avoid
- you are not using Jekyll or a static site generator
- you need a dynamic server-side application or database-backed site
- you want a highly opinionated, heavily styled design out of the box
- you need a WordPress or JavaScript framework theme

## Facets
- artifact type: plugin
- maturity: stable
- function: static-site-generator, templating, search-engine, theme
- domain: web-development, web-design, documentation, developer-tools
- platform: ruby, self-hosted
- tags: jekyll, jekyll-theme, github-pages, blog, portfolio, responsive-design, ruby-gem, seo, web-server

## Member repositories
- mmistakes/minimal-mistakes (main) score 90

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:11:03.541489+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:13:12.718592+00:00, confidence not recorded.
  - readme: https://github.com/mmistakes/minimal-mistakes (fetched 2026-08-28T04:11:03.541489+00:00, sha 33126c597bca)
  - homepage: https://mmistakes.github.io/minimal-mistakes/ (fetched 2026-08-29T08:07:54.058071+00:00, sha 1408e4717ca0)
- Data as of 2026-08-30T08:39:29.467469+00:00.