More about the author
· 1 min read

Theme setup

25th December 2020

Getting started with Jekyll + alternate

alternate was designed as a portfolio theme for alternatyves, but you can use this theme to start a regular Jekyll blog and tweak it any way you like.


  1. Install Jekyll
  2. Add your site and author details in _config.yml.
  3. Get a workflow going to see your site’s output with Jekyll locally using Jekyll commands or Gulp.

Supply was built with Jekyll version 4.0.0, and should support newer versions as well.

Install the dependencies with Bundler:

$ bundle install

Run jekyll commands through Bundler to ensure you’re using the right versions:

$ bundle exec jekyll serve


Add your custom configuration in the _config file.

Exposed as a data file to give clients better access Set in the Data / Navigation section, look for navigation.yml in _data.

Look for footer.html in _includes to add your footer links.



You can change the site styling using Tachyons, look for sup-theme in the src folder.

Please refer to Tachyons documentation, you can also start with

Gulp commands with browser reload

In the terminal, simply run

gulp build

to build your site concatenate your css (in asset -> css)


gulp watch

This command builds the site locally on port 3000, with Browsersync so you can quickly revise design changes.

Preview your site with browser reload at: localhost:3000 Use the address localhost:3001 for additional help like grid preview, css highlight and more during development.




Read about collections in the Jekyll documentation.

chevronLeft icon Previous post

Markdown style sheet

Next post chevronRight icon

Theme development