Bitters

Scaffold styles, variables and structure for Bourbon projects.

Built for speed

Bitters is meant to help designers start projects faster by defining a basic set of variables and project structure.

Made to change

After you have Bitters installed, jump in and start customizing the styles and variables to your design and brand requirements.

Sass Structure

The Bitters folder should contain styles for all the basic elements used throughout the site’s style. It also contains folders for custom mixins and extends for your site as well. Add code to the existing files or add new files to the folders. Customize Bitters for your site as you see fit.

Variables

This houses all variables that are used, or will be used, in more than one file in your site. Variable names in Bitters that are used outside of the variables file start with $base to indicate that they are the most basic variables.

Grid Settings

Variables specifically created for Neat resets and breakpoints. To be used, these need to be imported separately from the rest of your base file above Neat in your main stylesheet. Otherwise just remove the file.

Typography

All type is based on $base-font-size which is set to 1em (16px) by default. The spacing around type is based on $base-line-height to keep a semi-baseline grid. All sizes are scaled up or down by a factor of .25.

Lists

All lists have stripped out styles. No bullets, no left padding. To add back the expected browser default styles add @extend %default-ul; or @extend %default-ul; to the <ul> or <ol> respectively.

Forms

Adds basic styles all form elements. The variables at the top of the file all inherit from the variables file but make it really easy to be overridden.

Flashes

Used for any error, warning or success messages in applications or forms. Specifically made for rails application notices.

Install Instructions

  1. Install Bitters: gem install bitters

  2. Install Bourbon and Neat (optional). Then cd to your Sass directory and run: bitters install

  3. The generated folder will contain all Bitters files. Import Bitters after Bourbon and Neat in your application.css.scss: @import "bitters/bitters";

  4. You’re all set. Now add to or remove Bitters styles.

In-depth instructions on Github