JekyllBlog

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.

3 previews
Desktop homepage1 / 3
Desktop captureTop of page

Actual screenshot captured by the server browser.

All pages & views 3

Screenshots show visual appearance; interactive behavior may differ.

Recorded 2026-10-02View source

What stands out

A quick read of the recorded project description.

01

A Jekyll blog theme distributed as a Ruby gem, enabled via the Gemfile and the theme field in _config.yml

02

Supports light, dark, and auto blog theme modes, with auto following system and browser settings

03

Accent colors for light and dark themes and the date format can be set separately in _config.yml

04

Built-in configuration items for GitHub, Twitter, Facebook, and Dribbble social links

05

Supports Disqus comments and Google Analytics, with comments able to be disabled per post

06

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.

JekyllBlog

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. 1

    Add gem "jekyll-theme-mint" to the Jekyll site's Gemfile and set theme: jekyll-theme-mint in _config.yml

  2. 2

    Run bundle to install dependencies, or install separately with gem install jekyll-theme-mint

  3. 3

    For local preview, run bundle exec jekyll serve and visit http://localhost:4000

  4. 4

    Build the gem with gem build jekyll-theme-mint.gemspec

  5. 5

    Third-party assets such as demo images, fonts, and icons must be checked separately under their own licenses

Read repository instructions

License & source material

Usage conditions & limitations

Free to use · keep license notice

This 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

google_analytics: your_google_analystics_tracker_id

Original README
https://github.com/aidewoode/jekyll-theme-mint/blob/master/LICENSEhttps://github.com/aidewoode/jekyll-theme-mint/blob/master/README.md

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

![screenshot](https://raw.github.com/aidewoode/jekyll-theme-mint/master/screenshot.png)

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).
Report a correction

Explore similar templates

Compare previews and descriptions within the same stack and category.