SCSS Toolkit

A starter toolkit based on SMACSS for Sass (SCSS) projects, with optional support for Compass.

SCSS Toolkit uses a combination of recommendations from:

• Adaptive Web Design
• Scalable and Modular Architecture for CSS (SMACSS)

Styles are broken down into the following groups: Base, Layout, Module, State

Quick Start

Clone the git repo - git clone git://github.com/davidrapson/scss-toolkit.git or download it

Requirements

As this project uses Sass it assumes you already have Ruby and Sass installed. This project requires Sass 3.2, you should be able to run bundle install in terminal to get everthing setup.

To watch the files for changes, either run sass --watch style/scss:style or use the watch.sh script.

Compass

I use Compass for all my projects so I've included a Compass config.rb file, but it's completely optional. SCSS Toolkit does not rely on Compass.

Changelog

This project attempts to follow the Semantic Versioning Specification.

• 1.2.1 - Add a example modules for articles, navigation and media objects.
• 1.2.0
  • Add more common colour scheme variables
  • Rename style.css to main.css to match HTML5 Boilerplate
• 1.1.1 - Fix load path error in ie.scss
• 1.1.0
  • Standardise variable names
  • Added Gemfile, .editorconfig and watch.sh (sass --watch script)
• 1.0.0
  • 1.0.0 release

License

Major components:

• Normalize.css: Public Domain

Everything else:

The Unlicense (aka: public domain)

Thanks & Resources

This toolkit is based on the work of the following fine people & projects.

• HTML5 Boilerplate
• Normalise.css
• Scalable and Modular Architecture for CSS (SMACSS)
• Adaptive Web Design (book)
• Jake Archibald for the Sass IE implementation
• Ben Bodien for his advice and feedback