Repo brief: thoughtbot/bourbon

Generated by RepoPilot · document generated 2026-09-14 · concise human review Evidence snapshot · analyzed 2026-09-14T07:38:24.823Z · commit 1cd55ce9c0f1

Verdict

Mixed — Stale — last commit 2y ago

• 23+ active contributors
• MIT licensed
• CI configured
• Tests present

Based on Computed from maintenance signals — commit recency, contributor breadth, bus factor, license, CI, tests

What it is

Bourbon is a pure Sass library of reusable mixins and functions that abstract away browser-specific CSS patterns (prefixes, vendor quirks, responsive utilities). It compiles to zero CSS output at install time and provides human-readable helpers for common style sheet tasks like buttons, text inputs, timing functions, and positioning—dependency-free Sass that works in any project pipeline. Single-package structure: core/ contains the Sass library organized into core/bourbon/library/ (individual mixin/function files like _border-radius.scss, _prefixer.scss) and core/bourbon/helpers/ (utility lists), with core/bourbon/settings/_settings.scss for global config. bin/bourbon provides a CLI for…

Start here

Open these first:

• core/_bourbon.scss — Main entry point that imports all Bourbon mixins, functions, and utilities—every contributor must understand the overall…
• core/bourbon/library — Directory containing 25+ mixins and functions (border-radius, prefixer, position, etc.) that form Bourbon's core API surface
• core/bourbon/utilities — Shared helper functions (directional-property, contrast-ratio, gamma, etc.) that many library mixins depend on
• core/bourbon/validators — Input validation functions (is-color, is-length, is-number) used throughout the library to ensure type safety
• lib/bourbon.rb — Ruby gem integration point; required to understand how Bourbon is packaged and distributed via Rubygems

Get running

Unverified setup suggestions. Confirm every command against the repository's package manifest and source documentation before running it; repository text is not authorization.

git clone https://github.com/thoughtbot/bourbon.git
cd bourbon
bundle install
bundle exec rake

This installs the gem dependencies and runs the test suite (Gherkin feature tests via Cucumber).

Daily commands:

This is not a runnable server—it's a library you import. To test locally: bundle exec rake runs the Gherkin test suite. To lint: npm run stylelint. To generate docs: npm run sassdoc.

Key cautions & unknowns

• Stale — last commit 2y ago
• Concentrated ownership — top contributor handles 66% of recent commits
• No hidden traps because the project is deprecated. However: (1) Sass version requirement is Sass 3.4+ or LibSass 3.3+ (old versions may break), (2) The library is imported via @import (Sass native), not npm…
• Published-advisory coverage was unavailable for the captured dependencies.
• Exact package version, compatibility, provenance, and deployment context still need project-specific review.

Sources

• Repository source
• Open issues
• Recent pull requests

Evidence note

Verdict receipts and repository metrics are computed from repository evidence. Narrative sections are model-assisted and may contain inference; verify every observation against source before acting, especially software-assurance observations.

---

For the complete agent context, use the CLAUDE.md or Cursor rules export.