Compass Colors

This compass extension provides support for working with colors in Sass and generating color themes for use on your website.

Installing

sudo gem install compass-colors

To install a theme into your existing compass project, add the following to your compass configuration file:

require 'compass-colors'

Then run this command:

compass install colors/<Theme Name>

Where <Theme Name> is one of: basic, complementary, triadic, split_complement, analogous

The _theme.sass partial can then be imported into your stylesheets and the color constants can be used.

@import theme.sass

With all of these themes, you must pick a base color and the theme takes it from there:

lighten(color, percentage) - Create a color lighter by the percent amount provided.
darken(color, percentage) - Create a color darker by the percent amount provided.
saturate(color, percentage) - Increase the saturation of a color by the percent amount provided.
desaturate(color, percentage) - Decrease the saturation of a color by the percent amount provided.
hue(color) - Extract the hue from the color in degrees (0-360). Suitable to be passed as the first argument of hsl.
saturation(color) - Extract the saturation from the color in percent (0-100). Suitable to be passed as the second argument of hsl.
luminosity(color) - Extract the luminosity from the color in percent (0-100). Suitable to be passed as the third argument of hsl.
mix(color1, color2, percentage) - Create a new color by mixing two colors together. Percentage (0-100) is optional, and indicates how much of color2 should be mixed into color1.
grayscale(color) - Create a gray color by mapping the color provided to the grayscale.
adjust_hue(color, degrees) - Add the number of degrees provided to the hue of the color keeping luminosity and saturation constant. Degrees can be negative.
complement(color) - Returns the compliment of the color provided.