Minimalistic theme is based on gh-pages minimal theme, with navigation in the sidebar and super amazing features. Wanna see it in action? You can view a live demo at Minimalistic.


  1. Auto light/dark mode.
  2. Syntax Highlighting for light/dark mode.
  3. Logo Support for the page.
  4. Links in Sidebar.
  5. List/Sublist in Sidebar.
  6. Fully responsive with mobile support.
  7. Logo/Favicon Support.
  8. Github-Pages Support.
  9. Card Support
  10. Under active development.
  11. And many more. 😁


You can refer to this Wiki Link if you want to use this theme for creating github pages for your own custom repository.

To use the Minimalistic theme:

  1. Add the following line to your Gemfile
gem "jekyll-remote-theme"

then run bundle install to install the plugin.

  1. Add the following to your site's _config.yml to activate the plugin:
  - jekyll-remote-theme

Note: If you are using a Jekyll version less than 3.5.0, use the gems key instead of plugins.

  1. Add the following line to your config.yml to use the theme
remote_theme: vaibhavvikas/jekyll-theme-minimalistic

then running bundle exec jekyll serve for local deployment.


Configuration variables

Minimalistic will respect the following variables, if set in your site's _config.yml:

title: [The title of your site]
description: [A short description of your site's purpose]

Additionally, you may choose to set the following optional variables:

google_analytics: [Your Google Analytics tracking ID]

Choose light, dark, or automatically adjusting theme based on system theme:

color-scheme: auto/light/dark

Specify logo for the website:

logo: /assets/img/<logo_file>

Enable favicon by putting a favicon.ico in the repo's root directory and add the following line in config.yml:

favicon: true

Customizing Sidebar

You can define a list of platforms that are linked from the sidebar in _config.yml:

  - name: GitHub
    icon: <i class="fa-brands fa-github"></i>
  - name: LinkedIn
    icon: <i class="fa-brands fa-linkedin"></i>
  - ...

You can also define, hyperlinks for specific pages or section of a pages (very helpful if creating multipage documentation or easy navigation between multiple sections).

For adding navigation do the following steps:

  1. Put your .md files in the root directory. and add the below text on top of pages to get it converted to html by jekyll.
layout: default
  1. Use the navigation example below to add navigation section in _config.yml file. Treat all your .md files as .html files. Currently it only supports one nesting in sublist.
  - name: Readme
    link: ./index.html
      - name: Image
        link: ./index.html#small-image
  - name: Another Page
    link: ./another-page.html
  - ...


Live Example
Code used in GitHub page

Lets say you have a file name, you put that into the root dir. Now, add the text in step 1 at the top of the md file. After that for the text in _config.yml you will put it like:

  - name: [Write name of your hyperlink]
    link: ./xyz.html

Adding Card:

Use the code template:

<div class="card">
  <h3>Some Title</h3>
  <p><b>New Delhi</b>, India<br>
  Some Text</p>
  <a href=""><span class="card-link-spanner"></span></a>


If you'd like to add your own custom styles:

  1. Create a file called /assets/css/style.scss in your site

  2. Add the following content to the top of the file, exactly as shown:

    @import "{{ site.theme }}";
  3. Add any custom CSS (or Sass, including imports) you'd like immediately after the @import line

Note: If you'd like to change the theme's Sass variables, you must set new values before the @import line in your stylesheet.

Customizing Google Analytics code

Google has released several iterations to their Google Analytics code over the years since this theme was first created. If you would like to take advantage of the latest code, paste it into _includes/head-custom-google-analytics.html in your Jekyll site.

Previewing the theme locally

If you'd like to preview the theme locally (for example, in the process of proposing a change):

  1. Clone down the theme's repository (git clone
  2. cd into the theme's directory
  3. Run script/bootstrap to install the necessary dependencies
  4. Run bundle exec jekyll serve to start the preview server
  5. Visit localhost:4000 in your browser to preview the theme

Running tests

The theme contains a minimal test suite, to ensure a site with the theme would build successfully. To run the tests, simply run script/cibuild. You'll need to run script/bootstrap once before the test script will work.


All contributions and suggestions are welcome.


This theme was built using Minimalist theme by BDHU and Minimal by GithHub.