wordpressdev / bootstrap-sass

bootstrap-sass is bootstrap for Sass, ready to roll

Bootstrap for Sass

bootstrap-sass is an Sass-powered version of Bootstrap, ready to drop right into your Sass powered applications.

Installation and Usage

Please see the appropriate guide for your environment of choice:

• Rails
• Compass
• ---Sass--- (supported soon)

Development

Upstream Converter

Keeping bootstrap-sass in sync with upstream changes from Bootstrap used to be an error prone and time consuming manual process. With Bootstrap 3 we have introduced a converter that automates this.

Upstream changes to the Bootstrap project can now be pulled in using the convert rake task.

Here's an example run that would pull down the 3.0.0-wip branch from the main twbs/bootstrap repo (defaults to master):

bundle exec rake convert[3.0.0-wip]

The latest converter script is located here and does the following:

• Converts upstream bootstrap LESS files to its matching SCSS file.
• Copies all upstream JavaScript into vendor/assets/javascripts/bootstrap
• Generates a javascript manifest at vendor/assets/javascripts/bootstrap.js
• Copies all upstream font files into vendor/assets/fonts/bootstrap
• Sets Bootstrap::BOOTSTRAP_SHA in version.rb to the branch sha.

This converter fully converts original LESS to SCSS. Conversion is automatic but requires instructions for certain transformations (see converter output). Please submit GitHub issues tagged with conversion.

Credits

bootstrap-sass has a number of major contributors:

• Thomas McDonald
• Tristan Harward
• Peter Gumeson
• Gleb Mazovetskiy

and a significant number of other contributors.

You're in good company

bootstrap-sass is used to build some awesome projects all over the web, including Diaspora, rails_admin, Michael Hartl's Rails Tutorial, gitlabhq and kandan.