Particle Jekyll Theme

This is a simple and minimalist template for Jekyll designed for developers that want to show of their portfolio.

The Theme features:

  • Gulp
  • SASS
  • Sweet Scroll
  • Particle.js
  • BrowserSync
  • Font Awesome and Devicon icons
  • Google Analytics
  • Info Customization

Basic Setup

  1. Install Jekyll
  2. Clone the particle theme: git clone
  3. Edit _config.yml to personalize your site.

Site and User Settings

You have to fill some informations on _config.yml to customize your site.

# Site settings
description: A blog about lorem ipsum dolor sit amet
baseurl: "" # the subpath of your site, e.g. /blog/
url: "http://localhost:3000" # the base hostname & protocol for your site

# User settings
username: Lorem Ipsum
user_description: Anon Developer at Lorem Ipsum Dolor
user_title: Anon Developer
email: [email protected]
twitter_username: lorem_ipsum
github_username:  lorem_ipsum
gplus_username:  lorem_ipsum

Don't forget to change your url before you deploy your site!

Color and Particle Customization

  • Color Customization
    • Edit the sass variables
  • Particle Customization
    • Edit the json data in particle function in app.js
    • Refer to Particle.js for help

Running the blog in local

In order to compile the assets and run Jekyll on local you need to follow those steps:

  • Install NodeJS
  • Install Jekyll: sudo gem install bundler jekyll
  • Install Yarn: npm install -g yarn
  • Install dependencies: yarn
  • Run: gulp


This theme is free and open source software, distributed under the The MIT License. So feel free to use this Jekyll theme anyway you want.


This theme was partially designed with the inspiration from these fine folks