A Jekyll blog theme distributed as a Ruby gem, enabled via the Gemfile and the theme field in _config.yml
jekyll-theme-mint — Jekyll Blog Template
By aidewoode
jekyll-theme-mint is an MIT-licensed Jekyll blog theme focused on readability and accessibility, with light and dark theme switching, accent color configuration, social links, Disqus comments, and Google Analytics.
Explore the design
Compare the page layouts and mobile experience. Open any screenshot for a closer look.
Actual screenshot captured by the server browser.
All pages & views 3
Screenshots show visual appearance; interactive behavior may differ.
What stands out
A quick read of the recorded project description.
Supports light, dark, and auto blog theme modes, with auto following system and browser settings
Accent colors for light and dark themes and the date format can be set separately in _config.yml
Built-in configuration items for GitHub, Twitter, Facebook, and Dribbble social links
Supports Disqus comments and Google Analytics, with comments able to be disabled per post
Page links appear in the header by default and can be moved to the footer via is_footer in Front Matter
Template Details
jekyll-theme-mint is a blog theme for Jekyll sites. The repository describes it as clean and responsive, with a design goal centered on readability and accessibility. The theme is distributed as a Ruby gem, can be included via the Gemfile, and is enabled through the theme field in _config.yml.
At the configuration level, the theme provides several _config.yml options: blog_theme can be set to light, dark, or auto, where auto switches automatically when the system and browser support it; light-theme-accent-color and dark-theme-accent-color control the accent colors for the light and dark themes respectively; date_format customizes the date display format. Social links support four fields: github_username, twitter_username, facebook_username, and dribbble_username.
For feature integrations, entering a disqus_shortname enables Disqus comments, which can be disabled per post with comments: false in the post's Front Matter; entering a google_analytics tracking ID enables Google Analytics. Page links appear in the site header by default; if is_footer: true is set in a page's Front Matter, they appear in the footer instead.
For development and building, the README provides commands for installing dependencies with bundle install, previewing locally with bundle exec jekyll serve (default http://localhost:4000), and building the gem with gem build jekyll-theme-mint.gemspec. The theme uses the MIT license, allowing free use, modification, commercial use, and distribution, but third-party assets such as demo images, fonts, and icons must be checked separately under their own licenses.
Is it right for your project?
Use Cases
- Building a personal blog with Jekyll and needing light and dark theme switching
- Wanting to add social links, comments, and analytics with minimal _config.yml configuration
- Needing a site structure where some page links appear in the footer instead of the header
Suitable For
- Developers building blogs with Jekyll
- Users who prefer to configure theme appearance and integrations centrally through _config.yml
- Projects that need a blog theme that can be modified and distributed under the MIT license
Getting started & customization
Use these recorded setup notes alongside the repository instructions for your chosen version.
- 1
Add gem "jekyll-theme-mint" to the Jekyll site's Gemfile and set theme: jekyll-theme-mint in _config.yml
- 2
Run bundle to install dependencies, or install separately with gem install jekyll-theme-mint
- 3
For local preview, run bundle exec jekyll serve and visit http://localhost:4000
- 4
Build the gem with gem build jekyll-theme-mint.gemspec
- 5
Third-party assets such as demo images, fonts, and icons must be checked separately under their own licenses
License & source material
Usage conditions & limitations
Free to use · keep license noticeThis entry covers the free version in the public repository under the MIT license; the free scope applies to that version's code and does not mean external services or third-party assets are free.
Must comply with when using
- The code of this version may be used, modified, used commercially, and distributed free of charge.
- When distributing copies or substantial portions of the code, retain the original author's copyright notice and the full MIT license notice.
- The code is provided as is; warranties and limitations of liability are governed by the original license and applicable law.
Additional costs & items to verify
- Enabling Disqus comments requires entering your own Disqus shortname in _config.yml, meaning it depends on the third-party Disqus service and account.
- Enabling Google Analytics requires entering your own Google Analytics tracking ID, meaning it depends on the third-party Google service and account.
- Demo images, fonts, icons, and other third-party assets must be checked under their own licenses and cannot be judged solely by the code's MIT license.
- External services such as domains, hosting, databases, payments, or AI may incur separate charges.
View Original Text Basis
Permission is hereby granted, free of charge
Original License Text
disqus_shortname: your_disqus_shortname
Original README
https://github.com/aidewoode/jekyll-theme-mint/blob/master/LICENSEhttps://github.com/aidewoode/jekyll-theme-mint/blob/master/README.mdgoogle_analytics: your_google_analystics_tracker_id
Original README
Compiled by DeepSeek based on repository license and README ·2026-10-02. Results only cover the materials read; dependencies, images, fonts, and subsequent term changes are subject to their respective original texts.
Project checks & description sources
Template Information
- Source platforms
- GitHub
- Documentation and maintenance reference score
- Partly documented · 72 / 100
- Technologies
- Jekyll
- Website type
- Blog
How this score is calculated
Our heuristic uses license records (up to 30), a demo link (12), a preview (10), stars (15), recorded maintenance (15), description completeness (8), feature records (5) and classification data (5). It is not a code, security or performance test, or a Google score. A link does not establish tested functionality.
What to verify for this project
- Repository update recorded
- 2022-07-15
- Screenshot last checked
- 2026-10-02
A demo link is listed. Check it with your own content and viewport sizes; its presence does not confirm that forms, authentication or payments work.
The catalog identifies Jekyll as the primary stack. Check the actual dependency manifest and lockfile for versions and hosting requirements. These notes use recorded metadata, not a code audit or a deployment test.
Use a selection guide →How this description was prepared
AI-assisted description based on catalog records and repository material. Repository authors are not automatically the reviewers of this description.
Automatically checked against source and license rules; no manual editorial review.
Inspect the recorded source material
SHA-256: 2617346dee8feb064db42167c62fcdc5cb6fff927479a0ae70ffd45d9f827c6a
2026-10-02T10:57:28.598Z
Source file / repository# jekyll-theme-mint

A clean and responsive jekyll theme. Designing for legibility and accessibility.
## Installation
Add this line to your Jekyll site's `Gemfile`:
```ruby
gem "jekyll-theme-mint"
```
And add this line to your Jekyll site's `_config.yml`:
```yaml
theme: jekyll-theme-mint
```
And then execute:
$ bundle
Or install it yourself as:
$ gem install jekyll-theme-mint
## Usage
### Theme
Edit `_config.yml` file to change blog theme.
```yaml
blog_theme: light # use light theme
# or
blog_theme: dark # use dark theme
# or
blog_theme: auto # auto change the theme when your system and browser supported
```
### Accent color of theme
Edit `_config.yml` file to change accent color of theme.
```yaml
light-theme-accent-color: '#333'
dark-theme-accent-color: '#eee'
```
### Add social links
Edit `_config.yml` file to add your social links.
```yaml
github_username: your_name
twitter_username: your_name
facebook_username: your_name
dribbble_username: your_name
```
### Customize date formate
Edit `_config.yml` file to change default date formate.
```yaml
date_format: '%b %-d, %Y'
```
### Enable Disqus
Edit `_config.yml` file to add your Disqus short name and you can enable Disqus on your site.
```yaml
disqus_shortname: your_disqus_shortname
```
You can also disable Disqus on specific post by `comments: false` to the post's Front Matter.
### Enable Google Analytics
Edit `_config.yml` file to add your google analytics tracking id and you can enable google analytics on your site.
```yaml
google_analytics: your_google_analystics_tracker_id
```
### Footer page
Normally, the links to the pages is displayed in the site header. If you want to display the page link on the footer, you can add this to the front matter of page.
``` yaml
is_footer: true
```
## Development
To set up your environment to develop this theme, run `bundle install`.
For test, you can run `bundle exec jekyll serve` and open your browser at `http://localhost:4000`.
For more information you can see here <https://jekyllrb.com/docs/themes/>.
## Build gem
$ gem build jekyll-theme-mint.gemspec
## License
The theme is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
Explore similar templates
Compare previews and descriptions within the same stack and category.

al-folio
A Jekyll academic homepage theme for scholars and researchers, with a clean responsive design and out-of-the-box support for publication lists, project showcases, CVs, and blogs.
Jekyll · Portfolio

minimal-mistakes
Minimal Mistakes is a two-column Jekyll theme for personal sites, blogs, project documentation, or portfolios.
Jekyll · Portfolio

Beautiful Jekyll
Beautiful Jekyll is a mature, easy-to-use Jekyll blog theme maintained by Dean Attali since 2015, with over 50,000 users.
Jekyll · Blog

jekyll-TeXt-theme
A customizable Jekyll theme for personal sites, team sites, blogs, projects, and documentation.
Jekyll · Blog

startbootstrap-clean-blog-jekyll
The official Jekyll version of Start Bootstrap's Clean Blog theme, offering a blog home page, about page, contact page, and sample post pages, with a Formspree-powered contact form.
Jekyll · Blog

So Simple
A minimal reading-oriented Jekyll theme by Michael Rose for personal blogs, portfolios, and long-form reading. It offers multiple layouts, microformat markup, Disqus comments, Google Analytics, Jekyll SEO Tag, three skins, and aggregation by year, category, and tag with a grid view.
Jekyll · Blog
