This starter kit for Jekyll follows the thoughtbot styleguide and includes our favorite front end tools.

Jekyll is a static site generator built in Ruby. This makes it a great fit for projects that may end up as a Ruby on Rails app.

• HAML: Simple template markup
• Coffeescript: Write javascript with simpler syntax
• Sass: CSS with superpowers
• Autoprefixer: Add vendor prefixes to CSS
• Bourbon: Sass mixin library
• Neat: Semantic grid for Sass and Bourbon
• Bitters: Scaffold styles, variables and structure for Bourbon projects.

We also recommend Refills for prepackaged interface patterns and Proteus for a collection of useful starter kits to help you prototype faster.

Set up your project in your code directory

git clone https://github.com/thoughtbot/proteus-jekyll.git your-project-folder
cd your-project-folder
git remote rm origin
git remote add origin your-repo-url

Install dependencies

bundle install

Run the server and watch for changes in your files

jekyll serve -w

Deploy to Github Pages

jekyll build && git subtree push --prefix build origin gh-pages

Or install the Proteus gem and enjoy some shortcuts.

Stylesheets, fonts, images, and javascript files go in the /source/_assets/ directory. Vendor stylesheets and javascripts should go in each of their /vendor/ directories.

If you have problems, please create a GitHub Issue.

Have a fix or want to add a feature? Pull Requests are welcome!

thoughtbot Jekyll Starter is maintained and funded by thoughtbot, inc. Thank you to all of the contributors!

Copyright © 2014–2015 thoughtbot, inc. thoughtbot Jekyll Starter is free software, and may be redistributed under the terms specified in the license.