Colorkit

Built on Compass and Sass, Colorkit provides a sensible default color library along with additional functions and mixins that make generating harmonious color schemes a breeze.

Checkout the Colorkit Codepen to play with a live version.

Installation:

Download or clone the Colorkit repo
Install the Colorkit gem sudo gem install colorkit
Run compass create specifying your project's directory (run compass create --help for further instructions). compass create my_project_name -r colorkit --using colorkit

To use Colorkit in an existing project:

Download and install Colorkit
Edit your project's config.rb file adding: require 'colorkit'

What Is It?

Colorkit includes a color library, the core mixins and functions, and your project specific color pallet.

Color Library

Colorkit's default color library is based off the primary colors red, yellow, and blue keywords defined in SVG and referenced in the Level 3 CSS Color Module. Secondary and tertiary colors are derived in equal parts using Sass's color functions. Each of these key-colors are then used in Colorkit's tint-stack, tone-stack, and shade-stack functions to produce a value stack for each. The color swatches are given a variable named based of the BEM naming methodology, as defined here, in the form of:

$color-name--value-name

example:

$red-orange--shade-3;

Mixins and Functions

Colorkit includes mixins and functions for creating color schemes, color stacks, and experimenting entire pallets by automaticlly generating class names to use with the pallet template. These are fairly well commented within the source, hopefully documentation here will be updated soon.

Color Pallet

The color-pallet.scss partial is the main settings file for using Colorkit and integrating it into your project. This is where you'll want to set all your color variables. Be sure to @include towards the top of your project's main stylesheet to be sure these variables are available project wide.

Credit

Color-stack functions were borrowed from Snugug's excellent toolkit