Best Free Jekyll Themes for GitHub Pages (2026)
The best free Jekyll themes that work seamlessly with GitHub Pages — no build step, no plugins, just push and deploy.
GitHub Pages is one of the best deals in web hosting: free, reliable, automatically SSL-terminated, and integrated directly into your Git workflow. Push to a branch, and your site is live within seconds. For Jekyll users, GitHub Pages has built-in support — no build step, no CI pipeline needed. But there is a catch: GitHub Pages only supports a curated whitelist of plugins, and runs Jekyll in safe mode. Not every theme is compatible.
This guide covers the best free Jekyll themes that work on GitHub Pages without a custom build pipeline. Every theme listed here can be installed with a few lines in your Gemfile and _config.yml — no GitHub Actions, no workarounds.
What “GitHub Pages compatible” actually means
A theme is GitHub Pages compatible if it uses only plugins from the official whitelist — primarily jekyll-feed, jekyll-sitemap, jekyll-seo-tag, jekyll-paginate, and a handful of others. Themes that require jekyll-archives, jekyll-paginate-v2, or custom Ruby plugins will not build on the default GitHub Pages pipeline.
There is a workaround: GitHub Actions. If you set up a custom Actions workflow, you can build Jekyll yourself with any plugin and deploy the output to GitHub Pages. This unlocks the full plugin ecosystem. But if you want the simplest possible setup — push to main, site is live — you need a natively compatible theme.
GitHub Pages currently runs Jekyll 3.10. Most modern themes support both Jekyll 3.x and 4.x, but check the theme’s documentation if you need Jekyll 4-specific features.
The best free GitHub Pages themes
Minimal Mistakes
Minimal Mistakes is the most popular free Jekyll theme ever made, and its popularity is completely deserved. It has been maintained by Michael Rose since 2013 and remains actively developed. The feature set is extraordinary for a free theme: nine colour skins (Default, Dark, Mint, Dirt, Sunrise, Aqua, Contrast, Neon, Plum), eight header overlays, six layout variants, complete SEO integration, six different comment systems (Disqus, Discourse, Facebook, utterances, giscus, Staticman), and UI localisation strings for over 35 languages.
The documentation is exceptionally thorough — a 50-plus-page website covering every configuration option. For most use cases, every question you could have about configuring the theme has already been answered in the docs.
Best for: Blogs, personal sites, technical portfolios, documentation
| GitHub stars: 12,000+ | View on JekyllHub → |
Chirpy
Chirpy is a modern, feature-rich blog theme built for technical writers. It comes with a three-column layout with a fixed sidebar, seamless dark and light mode switching, full-text search (via a client-side JSON index), post categories and tags with archive pages, automatically generated table of contents for long posts, and post last-modified dates.
What sets Chirpy apart from most themes is the quality of its defaults — posts look excellent out of the box without any customisation. Code blocks have syntax highlighting, copy buttons, and line numbers. Images support captions. The typography is carefully considered.
Chirpy requires a GitHub Actions workflow for its full feature set (particularly the archive pages, which use a plugin not on the whitelist). But its starter template includes a pre-configured Actions workflow, making setup nearly as simple as the whitelist-only themes.
Best for: Developer blogs, technical writing, tutorials
| GitHub stars: 8,000+ | View on JekyllHub → |
Minima
Minima is the default Jekyll theme — the one you get when you run jekyll new. It is deliberately minimal: clean typography, a simple two-column layout on wide screens, posts listed by date, and not much else. There is no dark mode, no search, and no sidebar.
That minimalism is precisely its value. If you want to focus entirely on writing, Minima gets out of the way. It is also the best starting point for learning how Jekyll theming works, since its source is straightforward enough to read and understand in an afternoon.
Minima v3 (the current version) supports dark colour scheme detection via prefers-color-scheme. Install the gem and set minima: skin: dark in _config.yml.
Best for: Simple blogs, getting started, learning Jekyll’s architecture
Just the Docs
If you are building documentation rather than a blog, Just the Docs is the clear choice. It is designed specifically for technical documentation: a left sidebar with collapsible nested navigation, a search box with instant results, breadcrumbs, full-width code blocks, callout blocks, and a light/dark colour toggle.
The navigation is driven by nav_order and parent front matter keys — you assign each page a numeric order and an optional parent page. The theme builds the sidebar hierarchy automatically. No data files, no plugins — just front matter.
Just the Docs is used by hundreds of open source projects including GitHub and Stripe tools. It is actively maintained and has good accessibility compliance.
Best for: Project documentation, API references, developer tools, knowledge bases
| GitHub stars: 5,000+ | View on JekyllHub → |
Hydejack
Hydejack is a premium-feeling free theme with some of the most distinctive visual design in the Jekyll ecosystem. It features a fixed sidebar with optional large cover image, offline support via Service Worker, blur-up image loading (low-resolution placeholder that sharpens as the full image loads), smooth page transitions, and support for math (via KaTeX) and resume/CV pages.
The free version is genuinely complete — not a crippled trial. The PRO version adds extra layouts (resume, projects, newsletter) and premium support, but most users will not need them.
Hydejack requires some configuration to set up correctly, but the documentation is comprehensive.
Best for: Developer portfolios, personal sites, designers who want something distinctive
| GitHub stars: 8,000+ | View on JekyllHub → |
Cayman
GitHub’s own official project theme — the clean, blue-accented layout you have seen on countless project landing pages. Cayman is a one-page layout: a large header with site title and description, a content area for your README or project info, and a sidebar on wide screens.
It is not designed for blogging — there is no post listing, no navigation between pages. It excels at what it was designed for: a polished landing page for a GitHub-hosted project.
Best for: Project pages, open source repo landing pages, single-page project sites
Jekyll Now
Jekyll Now is a theme specifically designed for absolute beginners — people who want to get a Jekyll blog running in under five minutes without touching the command line. Fork the repo, edit _config.yml directly on GitHub’s web interface, and your blog is live.
The design is clean and minimal. The theme includes built-in Disqus comment integration, Google Analytics support, and social links. It has not been updated as frequently as themes like Minimal Mistakes, but it remains a solid choice for quick starts.
Best for: Absolute beginners, quick personal blogs
| GitHub stars: 7,500+ | View on JekyllHub → |
Beautiful Jekyll
Beautiful Jekyll offers more visual polish than the purely minimal themes while remaining easy to set up. It supports post header images, multiple authors, Google Analytics, Disqus comments, and several layout variants. The README-based customisation guide is thorough and beginner-friendly.
A managed hosting option (Beautiful Jekyll Pages) exists for those who want hosting handled for them, but the open source version deploys perfectly on standard GitHub Pages.
Best for: Personal blogs with a bit more visual personality, non-technical bloggers
| GitHub stars: 4,500+ | View on JekyllHub → |
How to install a gem-based theme on GitHub Pages
Most of the themes above are distributed as Ruby gems. Installation is three steps:
1. Update your Gemfile:
source "https://rubygems.org"
gem "github-pages", group: :jekyll_plugins
gem "minimal-mistakes-jekyll" # Replace with your chosen theme
2. Update _config.yml:
theme: minimal-mistakes-jekyll # Replace with your chosen theme
3. Run bundle install locally, then push:
bundle install
bundle exec jekyll serve # Test locally
git add .
git commit -m "Add theme"
git push
GitHub Pages will pick up the Gemfile, install the theme gem, and build your site automatically.
Remote themes: more options without the whitelist restriction
GitHub Pages supports one mechanism for using themes that are not published as gems: the jekyll-remote-theme plugin, which is on the whitelist. This lets you point to any public GitHub repository as a theme:
# _config.yml
remote_theme: pmarsceill/just-the-docs@v0.7.0
Remote themes expand your options considerably — almost any theme hosted on GitHub can be used this way, even if it is not published on RubyGems. The trade-off is that remote themes are fetched at build time from GitHub, which adds a few seconds to your build.
When to use GitHub Actions instead
If you need any of these, set up GitHub Actions instead of relying on the built-in GitHub Pages builder: jekyll-archives for auto-generated tag/category pages, jekyll-paginate-v2 for more flexible pagination, any custom plugin not on the whitelist, or a specific Jekyll version (the built-in builder uses Jekyll 3.10 as of 2026).
The setup takes about 30 minutes but unlocks the full Jekyll ecosystem. See our GitHub Actions guide for a complete walkthrough with a starter workflow file.
Choosing the right theme
The best free GitHub Pages theme is the one that fits your content type and your tolerance for configuration. For a writing-focused blog with minimal setup: Minima or Beautiful Jekyll. For a technical blog with search, dark mode, and categories: Chirpy. For a documentation site: Just the Docs. For a portfolio with distinctive design: Hydejack. For the most flexible, most documented option: Minimal Mistakes.
Browse the full free theme collection on JekyllHub to filter by feature, category, and style.