Repolode
Submit
daattali

daattali/beautiful-jekyll

A ready-to-use Jekyll theme for building a clean, mobile-friendly personal, blog or project website quickly, especially on GitHub Pages.

Open-source alternative to:WixSquarespace

View on GitHubWebsite
Stars
5,835
Forks
17,288
Open issues
26
Last commit
23 days ago

What is it?

Beautiful Jekyll is a template for building personal sites, blogs, and simple project websites on top of Jekyll. The main path is to fork the repository, rename it to YOURUSERNAME.github.io, and edit a _config.yml file, after which GitHub Pages builds the site automatically. A Ruby gem installation option also exists, though support is limited to the GitHub-based setup.

Pages and posts are written in Markdown or HTML, with YAML front matter controlling per-page options such as titles, subtitles, cover images, tags, and comments. Blog posts go in the _posts folder and are rendered with a feed, tag index, and optional social sharing buttons.

The theme supports comment providers such as Disqus, Utterances, giscus, and Staticman, along with Google Analytics, search in the navigation bar, SEO and social metadata, and an automatically generated RSS feed.

Key features

  • 01Fork-and-deploy setup on GitHub Pages with no local tooling required
  • 02Mobile-first responsive layout with customizable background, logo, and cover images
  • 03Markdown-based pages and blog posts with YAML front matter for per-page settings
  • 04Built-in support for multiple comment providers and Google Analytics
  • 05Automatic RSS feed, tag index, and SEO and social sharing metadata

Use cases

  • Building a personal homepage or portfolio hosted on GitHub Pages
  • Starting a technical or personal blog with tags and RSS
  • Creating a simple project landing page for an open-source tool or研究 project

Quick start

  1. 1

    Fork the project on GitHub

  2. 2

    Rename the repository to YOURUSERNAME.github.io

  3. 3

    Edit _config.yml to customize your site settings

  4. 4

    Wait a minute or two, then visit https://YOURUSERNAME.github.io

Things to know

  • Designed primarily for GitHub Pages; the author provides no support when used via the Ruby gem.
  • Some features such as Dark Mode skins and removing the ad require a paid plan.

In collections

Static site generators & documentation tools

Topics

#jekyll#jekyll-theme#github-pages#blog#static-site-generator#responsive#jekyll-themes#ruby-gem

FAQ

What is beautiful-jekyll?
A ready-to-use Jekyll theme for building a clean, mobile-friendly personal, blog or project website quickly, especially on GitHub Pages. Beautiful Jekyll is a template for building personal sites, blogs, and simple project websites on top of Jekyll. The main path is to fork the repository, rename it to YOURUSERNAME.github.io, and edit a _config.yml file, after which GitHub Pages builds the site automatically. A Ruby gem installation option also exists, though support is limited to the GitHub-based setup.
Is beautiful-jekyll free to use? What license does it have?
beautiful-jekyll is open source under the MIT license. Check the license terms before using it in commercial products.
Is beautiful-jekyll still maintained?
Actively maintained. The last commit to beautiful-jekyll was on Oct 15, 2026.
What can I use beautiful-jekyll for?
Building a personal homepage or portfolio hosted on GitHub Pages Starting a technical or personal blog with tags and RSS Creating a simple project landing page for an open-source tool or研究 project
How do I install beautiful-jekyll?
Fork the project on GitHub Rename the repository to YOURUSERNAME.github.io Edit _config.yml to customize your site settings Wait a minute or two, then visit https://YOURUSERNAME.github.io
Where can I get beautiful-jekyll?
The source code and installation instructions are on GitHub: https://github.com/daattali/beautiful-jekyll

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects