Skip to content


Repository files navigation

Bitwiser Material theme for Jekyll.

A minimal material design theme using muicss.


  • Clean, simple and responsive layout
  • Code formatting.
  • Sitemap included.
  • Google analytics.
  • Disqus commenting (Loaded lazily).
  • Share post to facebook and twitter.
  • Robots.txt included.
  • Custom 404 error page.
  • Clean material theme.
  • Awesome navigation menu on small screens.
  • Post specific color or cover image.

Theme website:

Demo post:


Download latest Zip: Here

Or browse releases: Releases

Report issues: Issues

If you are using this theme, do not forget to ⭐ this repo or tweet @brijeshb42.

Pull requests are also welcome 👍.

Getting Started

(Assuming you know what Jekyll and Github pages are.)

  • Download this theme's zip file from here or clone the repository using git clone

  • Install ruby and then do gem install jekyll. This theme uses the latest jekyll version. So if you already have it installed, then upgrade it.

  • _config.yml describes all the variables which you are required to set. The description begins with double hash(##). And the value to be set is commented below it using #.

  • Edit _config.yml according to your requirements.

    • title : Your website name
    • disqus : disqusForumName If this value is present, disqus commenting will be automatically added to all your blog posts.
    • ga_id : googleAnalyticsID If this value is present, google analytics will be added to your website/blog. If ga_id is present, make sure that ga_domain is also present.
    • description: A short description of your website to be included in meta tag of your homepage
    • keywords : a few frequently used keywords on your site
    • links : This variable has a few commonly used social networks' links
      • facebook: facebookId
      • twitter : twitterHandle
      • email:
      • github: githubUsername
  • After setting the values in _config.yml, you can start adding posts in the _posts directory. Remove the example posts from the directory. The name of files in this directory should be according to specifications by jekyll, i.e, Note that the file name extenion can be anything from md, markdown, mkd, textile or html.

  • Replace the image files favicon.png and sharer.png with images of your own.

  • Test the site on local machine using jekyll serve in the theme directory.

  • If all works well, git push your changes to your github pages repository

  • Then visit your blog at

  • If you want to use a custom domain, then edit the CNAME file and add your own domain Make sure your domain points to github ip address.

New Feature

  • In every blog post, custom header color or cover image can be added.
  • While creating a blog post, just add extra color or cover or both attributes in th front matter of the post alongside title and date.
  • Value of color can be anything in [grey, orange, yellow, amber, light-blue, lime, teal, blue, black-87, blue-grey, brown, indigo, purple, deep-purple, red, pink].
  • See the demo of all the colors here
  • And the value of cover can be an absolute url of an image or a relative url like /img/post-cover.jpg. If using relative url, make sure the image is added in the img directory.