A simple portfolio Jekyll theme
CSS HTML JavaScript
Switch branches/tags
Nothing to show
Clone or download
Pull request Compare This branch is 27 commits ahead, 14 commits behind nrandecker:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


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:

  • Particle.js
  • Font Awesome and Devicon icons
  • Info Customization

Basic Setup

  1. Install Jekyll
  2. Fork the Particle Theme
  3. Clone the repo you just forked.
  4. 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: anon@anon.com
twitter_username: lorem_ipsum
github_username:  lorem_ipsum
linkedin_username:  lorem_ipsum
 - devicon-css-class-here

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:

  • Run jekyll serve


Having any issues file a GitHub Issue.


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 forked from Nathan Randecker, and modified to take advantage of Jekyll and Liquid