hazelnut

Hazelnut: A barebones starting point for Jekyll

About this site template:

This is a Jekyll template which uses Sass and CoffeeScript for assets, and Rake tasks for handy help with development. It assumes you’re using Pow to serve your site locally. Since this is geared for designers starting from scratch, there’s no styling.

If you’re a developer looking for pre-designed Jekyll themes, I’d recommend Poole by Mark Otto.

=====

Websites started from this template:

mig.io, my personal site. (View the repo.)
humblepied.com, a video interview site. (View the repo.)
basecamp.com, the marketing site for Basecamp.
basecamp.com/help, the help documentation site for Basecamp.
37signals.com/incoming-transmission, an archive of the best of the web.
thedistance.com, a new online magazine about hard-working, long-lasting businesses and the people behind them.

=====

First time setup:

1. Edit the Rakefile to add your Pow name, live URL, and GitHub repo
2. Edit the _config.yml to put in your own name and social media handles

=====

Basic rake tasks you’ll commonly use:

rake to watch and update your HTML, Coffee and Sass.

rake view builds a fresh copy of your site, then opens it locally.

rake view:xip generates an xip.io friendly URL and opens it.

rake view:github to head to your GitHub repository.

And as always, rake -T will provide you a list of all tasks.

=====

Adding new JavaScripts:

There’s no asset pipeline, but our rake tasks will automatically join any .coffee files we create into one file automatically for us.

All .coffee files should go into: _source/_assets/coffescript/
Any external JavaScript should go into: _source/assets/javascript/

=====

Adding new stylesheets:

Since there’s no asset pipeline, when we’re adding a new stylesheet we’ll need to do just two things. Let’s pretend we want to add a new stylesheet for an About page on our new site.

First, we’ll add our underscore-named file to the proper directory.
In our case, we’ll add this: _source/_assets/sass/pages/_about.scss

Last, we’ll define our new stylesheet inside the main style.scss file.

@import
  'pages/about', /* Adding a stylesheet for an About page. */
  'pages/home';

=====

About Mig:

I’m a graphic and web designer from Chicago. I proudly work at Basecamp to help make everyone’s favorite project management app better, and I teach at The Starter League.

=====

Questions?
@migreyes on Twitter is your best bet.

Elsewhere online:
http://mig.io
http://dribbble.com/migreyes
http://instagram.com/migreyes

=====

Happy making.