Bootstrap for Sass
bootstrap-sass is an Sass-powered version of Twitter's Bootstrap, ready to drop right into your Sass powered applications.
In your Gemfile:
gem 'sass-rails', '~> 3.1' gem 'bootstrap-sass', '~> 2.0.2'
Import "bootstrap" in your SCSS file of choice to get all of Bootstrap's styles, mixins and variables! We recommend against using
//= require directives, since none of your other stylesheets will be able to use the awesome mixins that Bootstrap has defined.
Need to configure a variable or two? Simple define the value of the variable you want to change before importing Bootstrap. Sass will respect your existing definition rather than overwriting it with the Bootstrap defaults. A list of customisable variables can be found in the Bootstrap documentation.
$primaryButtonBackground: #f00; @import "bootstrap";
Note: It's important that the file you are importing is not named
bootstrap, since this will cause an import loop. As a general rule, errors are something you should try to avoid.
//= require directives are useful, since there is no better alternative.
You can also load individual modules, provided you sort out any related dependencies.
//= require bootstrap-scrollspy //= require bootstrap-modal //= require bootstrap-dropdown
bootstrap-sass 2.0 now comes with support for Compass, meaning projects that don't use Rails can get in on the fun Bootstrap web.
Install the gem and create a new project using the gem.
gem install bootstrap-sass compass create compass-test -r bootstrap-sass --using bootstrap
This will sort a few things out:
- You'll get a starting
styles.scssready for your alterations
- You'll get a compiled stylesheet compiled & ready to drop into your application
Install the gem, add the require statement to the top of your configuration file, and install the extension.
gem install bootstrap-sass # In config.rb require 'bootstrap-sass' compass install bootstrap
You'll get the same benefits as those starting from scratch. Radical.
As per the Bootstrap project we don't include the responsive styles by default.
@import "bootstrap-responsive"; to get them.