bootstrap-sass is a Sass-powered port of Bootstrap 3 that brings the framework's styles and components into Sass-based projects.
The project solves the problem of integrating Bootstrap into applications that use Sass for stylesheet compilation. Rather than working with pre-compiled CSS, developers can import Bootstrap's Sass files directly, gaining access to the framework's variables and mixins for customization. This approach allows teams to leverage Bootstrap's component library while maintaining control over the final stylesheet output through Sass compilation.
The tool is suited for Rails applications using the asset pipeline, as well as projects using Bower or npm with Node.js build systems. Rails developers can add the gem to their Gemfile and import Bootstrap styles into their application stylesheet, with careful attention to import order and avoiding certain Sprockets directives that prevent access to Bootstrap's mixins. The project explicitly notes that Bootstrap 4 users should use the Bootstrap rubygem for Ruby environments or the main Bootstrap repository otherwise, making clear that this port targets Bootstrap 3 specifically. For Bower users, the package works with node-sass and integrates with asset managers like wiredep. The README provides separate installation paths for Rails, Bower, and npm environments, each with specific configuration requirements.
The project maintains active support across multiple package managers and build systems, with installation guides tailored to Rails versions, Bower workflows, and Node.js environments. The codebase is written in SCSS and remains compatible with various asset pipeline configurations, including Rails 4.x and Bower-based setups with Mincer.
