Understand why a legacy Rails or Sass codebase imports Bourbon and plan a migration away from it.
Follow the official migration guide to replace Bourbon helpers with native CSS equivalents.
Use existing Bourbon mixins in an older Ruby on Rails project that has not yet been updated.
Deprecated, the team recommends migrating to native CSS instead of using Bourbon in new or existing projects.
Bourbon was a library of tools for Sass, a language that extends CSS to make writing styles for websites easier. Sass lets you use variables, functions, and reusable chunks of code called mixins. Bourbon provided a curated set of those mixins and functions to handle common styling tasks without adding bloat or imposing a visual style on your project. The key thing to know upfront is that this project was deprecated in September 2024 and is no longer maintained. The team behind it posted a blog post explaining how to replace each of Bourbon's helpers with modern CSS features that browsers now support natively, since many of the problems Bourbon originally solved no longer require a library. When it was active, Bourbon was designed to be dependency-free (pure Sass with no other requirements), focused on readable code rather than terseness, and lightweight in that it added no extra output to your compiled CSS on its own. It worked with Ruby on Rails projects, as a standalone Ruby gem, and also through npm for JavaScript-based build pipelines. Installing it involved either a Ruby gem command or an npm package, then a single import line at the top of your Sass files. Once imported, all of Bourbon's mixins and functions were available throughout your stylesheets. It also included a small command-line tool with install and update commands. If you are looking at this project because it appears in an existing codebase, the README recommends migrating away from it toward native CSS. If you are considering using it in a new project, it is no longer a suitable choice given that it receives no further updates.
← thoughtbot on gitmyhub — every repo by this author, as a profile.
Verify against the repo before relying on details.