Skip to main content

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

FlagThemeBootstrap defaultEffect
$enable-dark-modetruetrueEmits 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-cssgridtruefalseAdds .grid, .g-col-*, .g-start-* and the responsive variants. The flexbox grid stays on as well. CSS grid
$enable-negative-marginstruefalseAdds .m-n1 … .m-n8 (and the side variants) for every spacing step. Spacing
$enable-shadowsfalsefalseComponents ship flat. The --bs-box-shadow* variables and .shadow* utilities still exist for opt-in depth. Shadows
$enable-gradientsfalsefalseNo 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

FlagValueNote
$enable-carettrueDropdown carets, including on <summary class="dropdown-toggle">
$enable-roundedtrueRadii apply. The theme sets them to 2 / 6 / 12 px. Radius
$enable-transitionstrueDurations come from the motion tokens (120 / 200 / 320 ms)
$enable-reduced-motiontruePer-component prefers-reduced-motion rules. The theme adds a root-level override on top. Reduced motion
$enable-smooth-scrolltruescroll-behavior: smooth on the root when motion is allowed. Carousel tracks always smooth-scroll
$enable-grid-classestrueFlexbox .row / .col-*
$enable-container-classestrue.container, .container-fluid, .container-{bp}
$enable-button-pointerstruecursor: pointer on buttons; the theme extends it to summary toggles and label buttons
$enable-rfstrueResponsive font sizes for headings and display classes
$enable-validation-iconstrueTick and alert icons inside :user-valid / :user-invalid fields
$enable-deprecation-messagestrueBootstrap's own warnings (not Sass deprecations)
$enable-important-utilitiestrueUtilities 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.

VariableThemeBootstrap default
$min-contrast-ratio4.54.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

VariableDefaultEffect
$rb-enable-google-fontstrueEmit the Google Fonts @import for Big Shoulders Display. Self-hosting
$rb-tabs-max12How many tabs a radio tab group can pair with panes by index. Navs & tabs
$rb-scrollspy-max12How many sections a scrollspy can track. Scrollspy
$prefixbs-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";