HTML, CSS, and JS toolkit from Twitter – Sassified for the Rails asset pipeline
Ruby JavaScript
Pull request Compare This branch is 1 commit ahead, 249 commits behind mjonuschat:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Bootstrap is Twitter's toolkit for kickstarting CSS for websites, apps, and more. It includes base CSS styles for typography, forms, buttons, tables, grids, navigation, alerts, and more.

Twitter Bootstrap has been converted to Sass which makes it possible to use the default Rails Asset Pipeline

  • All assets have been namespaced within twitter/bootstrap to avoid naming conflicts
  • Top level requires for sprockets to get the complete bundle with a simple = require twitter/bootstrap
  • Ability to import individually namespaced stylesheets or javascripts.



The easiest way to use Twitter Bootstrap is to require it in your application.css file.

 *= require twitter/bootstrap

#example {
  /* Your styles... */

If you need access to the variables within the Twitter Bootstrap framework or want to use the mixins you will need to import it within an .css.scss file. This will still include the complete framework.

@import "twitter/bootstrap";

#foo {
  @include border-radius(4px);

Using only parts of the framework like variables and mixin you can import all of these individually from within .css.scss files.

@import "twitter/bootstrap/variables";
@import "twitter/bootstrap/mixins";

@mixin myButton($radius: 5px) {
  @include border-radius($radius);

#foo {
  @include myButton(10px);


Using the JavaScript works the same way. You can include them all with a single require directive from your application.js.

//= require twitter/bootstrap


If you only want a part of the javascripts require the individual files from your .js file.

//= require twitter/bootstrap/modal



This gem will directly track the semantic versioning releases of the Twitter Bootstrap project. If it should be necessary a build number will be added to the version to mark releases specific to this gem.

Note on Patches / Pull Requests

  • Fork the project.
  • Make your feature addition or bug fix.
  • Add tests for it. This is important so I don't break it in a future version unintentionally.
  • Commit, do not mess with rakefile, version, or history. (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
  • Send me a pull request. Bonus points for topic branches.


This work incorporates Twitter Bootstrap by Twitter, Inc.
This gem has been inspired by less-rails-bootstrap by Ken Collins



Apache License, Version 2.0


Copyright 2011 Morton Jonuschat
Twitter Bootstrap copyright 2011 Twitter, Inc