Bootstrap on Rails

This project is now discontinued. Use the official https://github.com/twbs/bootstrap-sass for better support. The sass version works really well now.

A simpler implementation of Bootstap 3 for Rails. Only packaged assets. No bloat. Pure Less.

Current Bootstrap Version: 3.3.1
Supports Rails 3.1+ and Rails 4
Less only
Twitter Variables are easily overridable

Installation

Just add to your Gemfile

gem 'therubyracer', :platform => :ruby
gem 'less-rails'

gem 'bootstrap-on-rails'

Add a stylesheet or insert to your existing less file

@import "bootstrap/variables";

// insert your bootstrap overrides
// @linkColor: red;
// or import a variable file
// @import "variables";

@import "bootstrap/bootstrap";

// Uncomment For glyphicons + asset pipeline.
// @font-face {
//  font-family: 'Glyphicons Halflings';
//    src: asset-url("bootstrap/glyphicons-halflings-regular.eot");
//    src: asset-url("bootstrap/glyphicons-halflings-regular.eot?#iefix") format('embedded-opentype'),
//         asset-url("bootstrap/glyphicons-halflings-regular.woff") format('woff'),
//         asset-url("bootstrap/glyphicons-halflings-regular.ttf") format('truetype'),
//         asset-url("bootstrap/glyphicons-halflings-regular.svg#glyphicons-halflingsregular") format('svg');
// }
// see this for more info about glyphicons: https://github.com/jasontorres/bootstrap-on-rails/issues/3

To add the bootstrap javascript libraries, add to your application.js file

//= require bootstrap/affix
//= require bootstrap/alert
//= require bootstrap/button
//= require bootstrap/carousel
//= require bootstrap/collapse
//= require bootstrap/dropdown
//= require bootstrap/modal
//= require bootstrap/tooltip
//= require bootstrap/popover
//= require bootstrap/scrollspy
//= require bootstrap/tab
//= require bootstrap/transition

It's important to note that variables.less is taken out of bootstrap and required explicitly to support overriding variables, another motivation why I needed to do this gem.

Upgrading

If you're using your own custom variables.less, once in a while you'll get missing variables. Just in case that happens, just look it up on the main variables.less file here: https://github.com/twbs/bootstrap/blob/master/less/variables.less

Notes

bootstrap-on-rails now follows the same bootstrap versioning
An example project can be seen here https://github.com/jasontorres/bootstrap-on-rails-example

License

Bootstrap 3 is licensed under MIT License.

Bootstrap on Rails is under MIT License

Jason Torres of Proudcloud.net