Bourbon is a library of pure Sass mixins that are designed to be simple and easy to use. No configuration required. The mixins aim to be as vanilla as possible, meaning they should be as close to the original CSS syntax as possible.
The mixins contain vendor specific prefixes for all CSS3 properties for support amongst modern browsers. The prefixes also ensure graceful degradation for older browsers that support only CSS3 prefixed properties. Bourbon uses SCSS syntax.
Follow the @bourbonsass Twitter account for updates.
For command line help, visit our wiki page on Bourbon’s command line interface.
gem install bourbon
Alternatively, you can install Bourbon with Bower.
bourbon install
Pro Tip: You can target installation into a specific directory using the path
flag:
bourbon install --path my/custom/path/
@import "bourbon/bourbon";
It’s not recommended to add or modify the Bourbon files so that you can update them easily.
gem 'bourbon'
bundle install
application.css
to application.scss
: mv app/assets/stylesheets/application.css app/assets/stylesheets/application.scss
Delete all Sprockets directives in application.scss
(require
, require_tree
and require_self
) and use Sass’s native @import
instead. (why?)
Import Bourbon at the beginning of application.scss
. All additional stylesheets should be imported below Bourbon:
@import "bourbon";
@import "home";
@import "users";
Help! I’m getting an undefined mixin error.
npm install --save bourbon
If you’re using Eyeglass, skip to Step 3. Otherwise, you’ll need to add Bourbon to your node-sass includePaths
option. require("bourbon").includePaths
is an array of directories that you should pass to node-sass. How you do this depends on how node-sass is integrated into your project.
Import Bourbon into your Sass files:
@import "bourbon";
gem uninstall bourbon
-v
flag to specify the version you need: gem install bourbon -v 3.2.4
Also check out Proteus, a collection of useful starter kits to help you prototype faster. Each kit comes with Bourbon, Neat and Bitters out-of-the-box.
Copyright © 2011–2015 thoughtbot, inc. Bourbon is free software, and may be redistributed under the terms specified in the license.
Bourbon is maintained and funded by thoughtbot, inc. The names and logos for thoughtbot are trademarks of thoughtbot, inc.
We love open source software! See our other projects or hire us to design, develop, and grow your product.