Free and open-source Jekyll-based blog theme under the MIT license, with code that can be modified, used commercially, and distributed
blog (AminTaheri23) — Jekyll Blog Template
By AminTaheri23
AminTaheri23's blog is a free and open-source Jekyll-based blog theme, modified from simplygrey-jekyll and integrated with Super Search for real-time post search, under the MIT license.
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 2
Screenshots show visual appearance; interactive behavior may differ.
What stands out
A quick read of the recorded project description.
Derived from simplygrey-jekyll with modifications, and integrated with Super Search for real-time search of posts by title and description
Built-in homepage pagination, category archives, related posts, previous/next navigation, and Disqus comments
Includes a project list page and project detail pages, with project data spread across projects.md, _data/projects.json, and the _project/ directory
Supports social sharing, Google Analytics, sitemap, and XML Feed, and compresses output using Jekyll Compress HTML
Template Details
This is a blog theme for Jekyll. The repository states it is derived from simplygrey-jekyll with modifications, and the search functionality comes from Super Search. The theme provides homepage pagination, category archives, related posts, previous/next navigation, Disqus comments, a project list and project detail pages, social sharing, Google Analytics, and HTML output compression via Jekyll Compress HTML, while also generating a sitemap and XML Feed.
For content organization, posts go in the _posts/ directory with filenames following the "date-slug.md/.markdown" format. Front matter can declare title, date, categories, tags, and an image for og:image; categories require corresponding pages to be created under the category/ path first. Project content is spread across projects.md, _data/projects.json, and the _project/ directory, and personal information is edited in about.md.
Before use, you need to edit _config.yml to complete site settings; if you want to use the theme as the main site rather than a subpath site, you must remove the '/blog' prefix from the project. Local running depends on Ruby and Bundler; you can run bundle install and then preview via jekyll serve at 127.0.0.1:4000. The repository does not provide further details on style customization, browser compatibility, or deployment workflow.
Is it right for your project?
Use Cases
- Building a personal technical blog focused on post lists and category archives
- Content sites that need in-site real-time search of post titles and descriptions
- Developer homepages that want to display both a personal project list and project detail pages
- Blogs using Jekyll that need a sitemap, XML Feed, and basic SEO metadata
Suitable For
- Developers familiar with Jekyll and Markdown who are willing to edit configuration files directly
- Individual users who need a free, open-source blog theme whose code they can modify themselves
- Small to medium-sized blogs that organize content primarily by categories and posts
- Personal sites that need project showcase pages to coexist with a blog
Getting started & customization
Use these recorded setup notes alongside the repository instructions for your chosen version.
- 1
First fork the repository, then edit the site settings in _config.yml
- 2
Place posts in the _posts/ directory with filenames using the <date>-<slug>.md or .markdown format; categories must first be created under category/
- 3
Project content requires maintaining projects.md, _data/projects.json, and detail files under _project/ simultaneously
- 4
If you want to use the theme as the main site, remove all '/blog' path prefixes from the project
- 5
For local preview, run bundle install and then jekyll serve, and visit http://127.0.0.1:4000
License & source material
Usage conditions & limitations
Free to use · keep license noticeThis entry covers the free version under the MIT license in the public repository; the free scope is the code of this version and does not mean external services or third-party assets are free.
Must comply with when using
- You are allowed to use, modify, use commercially, and distribute the code of this version for free.
- 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
- The comment feature relies on the third-party Disqus service; you must register a Disqus site and configure the shortname yourself, and comment data is hosted by Disqus.
- The analytics feature relies on Google Analytics; you must apply for an account and enter the tracking ID yourself, and use is subject to Google's terms of service.
- The project is derived from simplygrey-jekyll with modifications; when redistributing, you must retain the upstream copyright and license notices.
- The real-time search feature comes from the third-party Super Search component; its own license terms must be followed when using it.
- HTML compression relies on the third-party Jekyll Compress HTML plugin; that plugin's license must be followed.
- Demo images, fonts, icons, and other third-party assets must be checked against their respective licenses and cannot be judged solely by the code's MIT license.
- External services such as domains, hosting, databases, payments, or AI may incur additional charges.
View Original Text Basis
Permission is hereby granted, free of charge
Original License Text
Disqus comment
Original README
Google analytics
Original README
This project forked and has been modified from [A simple grey theme for Jekyll]
Original README
the search posts using [Super Search]
Original README
https://github.com/AminTaheri23/blog/blob/master/LICENSEhttps://github.com/AminTaheri23/blog/blob/master/README.mdHTML Minify _(Compress HTML)_ using [Jekyll Compress HTML]
Original README
Compiled by DeepSeek based on repository license and README ·2026-10-01. 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
- More documented · 83 / 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
- 2026-09-08
- Screenshot last checked
- 2026-10-01
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: 949596b03e955472c4c60ec2027a0fb8d10ac47ae13904804370b4bf2a95568c
2026-10-01T14:32:33.518Z
Source file / repository## My blog > This project forked and has been modified from [A simple grey theme for Jekyll](https://github.com/liamsymonds/simplygrey-jekyll), > and the search posts using [Super Search](https://github.com/chinchang/super-search) > I got this from Agus ([agusmakmun](agusmakmun.github.io)) ### Demo * [https://amintaheri23.github.io/blog](https://amintaheri23.github.io/blog) #### Features * Sitemap and XML Feed * Pagination in homepage * Posts under category * Realtime Search Posts _(title & description)_ by query. * Related Posts * Highlight pre * Next & Previous Post * Disqus comment * Projects page & Detail Project page * Share on social media * Google analytics * HTML Minify _(Compress HTML)_ using [Jekyll Compress HTML](https://github.com/penibelst/jekyll-compress-html) ### Install & Configuration 1. Fork this repository 2. Edit site settings inside file of `_config.yml` 3. Edit your projects at file of `projects.md`, `_data/projects.json` and inside path of `_project/` _(for detail project)_. 4. Edit about yourself inside file of `about.md` 5. Remove the '/blog' from all of the project if you want this to be your main website. ### How to Use? **a. Add new Category** All categories saved inside path of `category/`, you can see the existed categories. **b. Add new Posts** * All posts bassed on markdown syntax _(please googling)_. allowed extensions is `*.markdown` or `*.md`. * This files can found at the path of `_posts/`. * and the name of files are following `<date:%Y-%m-%d>-<slug>.<extension>`, for example: ``` 2013-09-23-welcome-to-jekyll.md # or 2013-09-23-welcome-to-jekyll.markdown ``` Inside the file of it, ``` --- layout: post # (require) default post layout title: "Your Title" # (require) a string title date: 2016-04-20 19:51:02 +0700 # (require) a post date categories: [python, django] # (custom) some categories, but makesure these categories already exists inside path of `category/` tags: [foo, bar] # (custom) tags only for meta `property="article:tag"` image: Broadcast_Mail.png # (custom) image only for meta `property="og:image"`, save your image inside path of `static/img/_posts` --- # your content post with markdown syntax goes here... ``` #### Installing in your local **Option 1:** ``` bundle install --path vendor/bundle bundle exec jekyll serve ``` **Option 2:** If you already installed the jekyll ``` bundle install jekyll serve ``` Then visit the http://127.0.0.1:4000 **Updating the `Gemfile.lock`** ``` bundle update ```
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
