GitHub Pages themes

Themes that deploy to GitHub Pages.

Free and premium Jekyll themes you can host on GitHub Pages at no cost, with a custom domain and HTTPS. Here's which ones work out of the box and how to deploy the rest in minutes.

Jekyll themes for GitHub Pages

New Alcor Jekyll Theme preview

Jekyll 5

A free one-page Jekyll theme for freelancers and small studios. Light and dark mode, illustrations that match your colours, a contact form with no JavaScript, and it works on GitHub Pages in minutes.

Built-in build or GitHub Actions?

GitHub Pages can build Jekyll sites for you, but only with an approved list of plugins and a fixed Jekyll version. Simple themes like Alcor and Minimal Mistakes work with that built-in build directly. Feature-rich themes use more plugins and gems, so they build with a GitHub Actions workflow instead. It's still free, still automatic on every push, and it gives you full control over the Jekyll version.

Deploy a premium theme with GitHub Actions

  1. Push the theme to a GitHub repository and commit its Gemfile and Gemfile.lock.
  2. In the repository, open Settings → Pages and set Source to GitHub Actions.
  3. Add the workflow below as .github/workflows/pages.yml and push. Your site goes live at username.github.io/repository a minute later.
  4. Optional: add your own domain under Settings → Pages → Custom domain.
name: Deploy Jekyll site to Pages
on:
  push:
    branches: [main]
permissions:
  contents: read
  pages: write
  id-token: write
jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: ruby/setup-ruby@v1
        with:
          ruby-version: '3.3'
          bundler-cache: true
      - id: pages
        uses: actions/configure-pages@v5
      - run: bundle exec jekyll build --baseurl "${{ steps.pages.outputs.base_path }}"
        env:
          JEKYLL_ENV: production
      - uses: actions/upload-pages-artifact@v3
  deploy:
    needs: build
    runs-on: ubuntu-latest
    environment:
      name: github-pages
    steps:
      - uses: actions/deploy-pages@v4
Jekyll themes and how they deploy to GitHub Pages
ThemeBuilt withBest forGitHub Pages setupPriceLinks
Snowlake Jekyll Theme Jekyll Agency, Business GitHub Actions $79 Live demo
Livvic Jekyll Theme Jekyll Portfolio GitHub Actions $49.99 Live demo
Sandbox Jekyll Theme Jekyll Business, Portfolio GitHub Actions $99 Live demo
Deneb Jekyll Theme Jekyll Business GitHub Actions $79$59.25 Live demo
Izar Jekyll Theme Jekyll Portfolio GitHub Actions $59 Live demo
Alcor Jekyll Theme Jekyll Portfolio Built-in (template or remote_theme) Free Live demo
Dexfolio Jekyll Theme Jekyll Portfolio, Agency GitHub Actions $79 Live demo
Miles Jekyll Theme Jekyll Portfolio, Business GitHub Actions $79 Live demo
Agency Jekyll Theme Jekyll Portfolio Built-in (gh-pages branch) Free Live demo
Minimal Mistakes Jekyll Theme Jekyll Blog Built-in (remote_theme) Free Live demo

Frequently asked questions

Can I host a Jekyll theme on GitHub Pages for free?

Yes. GitHub Pages hosts static sites for free from a public repository, including a free github.io address and support for your own custom domain with HTTPS.

Why do premium themes need GitHub Actions?

GitHub Pages' built-in Jekyll build only allows a short list of plugins and a fixed Jekyll version. Premium themes often use more, so they build with a GitHub Actions workflow, which runs your own Gemfile and then publishes the result to Pages.

Is GitHub Actions free for this?

For public repositories, yes. Private repositories get a monthly allowance of free Actions minutes, and a Jekyll build usually takes a minute or two.

Can I use a custom domain?

Yes. Add your domain in the repository under Settings, Pages, then point a CNAME record (or A records for an apex domain) at GitHub. GitHub issues the HTTPS certificate for you.

What if I outgrow GitHub Pages?

Every theme here is a plain static site, so you can move to Cloudflare Pages or Netlify at any time without changing the theme.