Awesome Open Source
Awesome Open Source

License: MIT Gem Version

CodeFactor Codacy Badge


Home pagespeed

GitHub PageSpeed GitHub PageSpeed

Blog pagespeed

GitHub PageSpeed GitHub PageSpeed


This is a minimal jekyll theme for writing blogs and about yourself.


  1. Google Analytics
  2. Dark mode
  3. Disqus comments
  4. Categorization
  5. Emojis Support
  6. Highly optimized blog

    PageSpeed Insights

Desktop Preview

Home Page

Blog List Page

Mobile Preview

Home Page

Blog List Page


Add this line to your Jekyll site's Gemfile:

gem "dev-portfolio-blog"

And add this line to your Jekyll site's _config.yml:

theme: dev-portfolio-blog

And then execute:

$ bundle install

Or install it yourself as:

$ gem install dev-portfolio-blog


To start using the theme you either follow these steps or simply fork my repo and update the files.


Please use the theme as the plugin so that all the latest updated for this theme comes directly in your website.

Clone the branch master and change the theme accordingly.

Starting from the beginning:

Assuming that you started your first website based on minima theme from here

  1. Add a favicon.ico to the root directory for favicon.

  2. Create in the root folder ans set its yaml parameters to

layout: blog
permalink: /blog/
title: [Blog Page Title]
  enabled: true
  1. Change your yaml parameters to following
layout: description
permalink: /about/
title: About
  1. In the file add
layout: home
home_text: Text
title: [Home Page Title]
  1. Create a new file in root with following yaml parameters
layout: categories
permalink: /categories/
title: Categories
  1. In the _config.yml file add following and change accordingly

Path is relative to the root directory

resume_url: [PATH_TO_RESUME]
author_name: [YOUR_NAME]
description: [SITE_DESCRIPTION]
google_analytics: '[google analytics Id]'
    shortname: [discus-shotname]


Visit Jekyll-minifier and add this to your _config.yml file to enable minifier.


Visit jekyll-paginate-v2 and add this to your _config.yml file to enable pagination.

Check here _config.yml for example config file.

Writing a new blog

Create a new folder _posts in root folder if not already exists.

  1. Create a new markdown file in the format
  2. Make sure that disqus's shortname is valid.
  3. Add yaml configuartion to the post
layout: post
comments: [true | false]
title: Hello World
categories: [category1, category2]
Post Text.


  • Could not find a JavaScript runtime. See for a list of available runtimes Node JS is missing from your system. In ubuntu install using sudo apt-get install nodejs or refer to this


Bug reports and pull requests are welcome on GitHub at This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.


To set up your environment to develop this theme, run bundle install.

Your theme is setup just like a normal Jekyll site! To test your theme, run bundle exec jekyll serve and open your browser at http://localhost:4000. This starts a Jekyll server using your theme. Add pages, documents, data, etc. like normal to test your theme's contents. As you make modifications to your theme and to your content, your site will regenerate and you should see the changes in the browser after a refresh, just like normal.

When your theme is released, only the files in _layouts, _includes, _sass and assets tracked with Git will be bundled. To add a custom directory to your theme-gem, please edit the regexp in dev-portfolio-blog.gemspec accordingly.

Read about the themes and how it's implemented here


The theme is available as open source under the terms of the MIT License.

If you like my work, you can buy me a coffee here 😄

Buy Me A Coffee

Alternative Project Comparisons
Related Awesome Lists
Top Programming Languages
Top Projects

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
Html (253,320
Theme (43,366
Blog (28,577
Jekyll (18,164
Portfolio (13,197
Yaml (10,302
Root (8,284
Jekyll Themes (4,718
Html Css Javascript (2,605
Minifier (1,911
Jekyll Site (982
Jekyll Blog (527
Pagespeed (481
Jekyll Template (238
Minimal Theme (31