Customize
Options
The $enable-* flags the theme sets, the ones it leaves alone, and the contrast settings behind every text color.
How options work
Bootstrap gates whole features behind $enable-* Sass flags. The theme sets five of them in
scss/_variables.scss, which loads before Bootstrap's variables, so these values win over
Bootstrap's !default. They are not !default themselves: to change one,
set it between the theme's variables and Bootstrap's when importing parts.
Flags set by the theme
| Flag | Theme | Bootstrap default | Effect |
|---|---|---|---|
$enable-dark-mode | true | true | Emits the dark variable sets. Set explicitly because the theme's color-mode() mixin and the automatic prefers-color-scheme output depend on it. Color modes |
$enable-cssgrid | true | false | Adds .grid, .g-col-*, .g-start-* and the responsive variants. The flexbox grid stays on as well. CSS grid |
$enable-negative-margins | true | false | Adds .m-n1 … .m-n8 (and the side variants) for every spacing step. Spacing |
$enable-shadows | false | false | Components ship flat. The --bs-box-shadow* variables and .shadow* utilities still exist for opt-in depth. Shadows |
$enable-gradients | false | false | No gradient overlays on buttons, pills or progress bars. The brand layer has its own .bg-gold-ramp. Motifs |
Shadows and gradients match Bootstrap's defaults; they are pinned so a future Bootstrap change cannot flip them. The program-paper look is flat by design.
Flags left at Bootstrap defaults
| Flag | Value | Note |
|---|---|---|
$enable-caret | true | Dropdown carets, including on <summary class="dropdown-toggle"> |
$enable-rounded | true | Radii apply. The theme sets them to 2 / 6 / 12 px. Radius |
$enable-transitions | true | Durations come from the motion tokens (120 / 200 / 320 ms) |
$enable-reduced-motion | true | Per-component prefers-reduced-motion rules. The theme adds a root-level override on top. Reduced motion |
$enable-smooth-scroll | true | scroll-behavior: smooth on the root when motion is allowed. Carousel tracks always smooth-scroll |
$enable-grid-classes | true | Flexbox .row / .col-* |
$enable-container-classes | true | .container, .container-fluid, .container-{bp} |
$enable-button-pointers | true | cursor: pointer on buttons; the theme extends it to summary toggles and label buttons |
$enable-rfs | true | Responsive font sizes for headings and display classes |
$enable-validation-icons | true | Tick and alert icons inside :user-valid / :user-invalid fields |
$enable-deprecation-messages | true | Bootstrap's own warnings (not Sass deprecations) |
$enable-important-utilities | true | Utilities carry !important, including the theme's extras |
Contrast settings
Three more variables sit with the flags. They drive Bootstrap's color-contrast() function, which picks the text color for every .btn-*, .text-bg-*, badge and table variant at compile time.
| Variable | Theme | Bootstrap default |
|---|---|---|
$min-contrast-ratio | 4.5 | 4.5 |
$color-contrast-dark | $rb-navy-900 #0a1b3d | $black |
$color-contrast-light | $rb-cream-50 #faf3df | $white |
So "dark text" means navy ink and "light text" means program paper, never pure black or white. White and black
remain as last-resort candidates; secondary is the one color that falls through to white. The
reasoning, with ratios, is on Color.
HTML
<button type="button" class="btn btn-primary">navy on gold-700</button>
<button type="button" class="btn btn-navy">cream on navy-700</button>
<button type="button" class="btn btn-secondary">white on navy-300</button>
<button type="button" class="btn btn-warning">navy on gold-300</button>Theme-specific options
| Variable | Default | Effect |
|---|---|---|
$rb-enable-google-fonts | true | Emit the Google Fonts @import for Big Shoulders Display. Self-hosting |
$rb-tabs-max | 12 | How many tabs a radio tab group can pair with panes by index. Navs & tabs |
$rb-scrollspy-max | 12 | How many sections a scrollspy can track. Scrollspy |
$prefix | bs- | Unchanged. The compat tokens (--color-*, --space-* …) are not prefixed; the raw palette is --rb-* |
$rb-enable-google-fonts: false;
$rb-tabs-max: 6;
@import "@ropebreak/bootstrap/scss/rb-bootstrap";