Installation

CSS Installation

Download the CSS

This is the simplest way to get started with Shelves. Here's a big freaking button to download the latest generated CSS file:

Download CSS

Install Bower Component

Shelves is registered with Bower, and you can access both the generated CSS or the entire Sass framework from the component.

$ bower install --save shelves

Custom CSS Build

To customize the CSS without using Sass, you can use the included command line tool:

$ gem install shelves
$ shelves --width 1140px --columns 16 > grid.css

Nearly every Sass variable is available as a command line option, so be sure to run with --help to see everything that is available:

$ shelves --help

Sass Installation

This is the recommended way to use Shelves. Install using the gem command:

$ gem install shelves

or add Shelves to your Gemfile:

# ...
gem 'shelves'
# ...

With Shelves installed, it will automatically integrate with the most common frameworks: Rails, Sprockets, and Compass. So all you should have to do is @import it as usual:

// @import "shelves";   // Import just the mixins
@import "shelves-grid"; // Import mixins & default grid