bootstrap-on-rails's Introduction

Bootstrap on Rails

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

Current Bootstrap Version: 3.0.3
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.