The four layers
Bootstrap → Versa → optional theme → Custom. Bootstrap and Versa remain untouched. Bootstrap Icons is an optional, independently versioned vendor companion loaded alongside Bootstrap when icons are needed; it is not a fifth design layer.
<link href="/assets/vendor/bootstrap/css/bootstrap.min.css" rel="stylesheet">
<link href="/assets/vendor/bootstrap-icons/bootstrap-icons.min.css" rel="stylesheet">
<link href="/assets/versa/css/versa.css?v=0.24.1" rel="stylesheet">
<link href="/assets/custom/theme.css" rel="stylesheet">
<link href="/assets/custom/custom.css" rel="stylesheet">Theme tokens
The public Theme API controls brand and semantic colors, readable foreground pairs, page and component surfaces, typography, radii, shadows, motion, gradients and application heroes. Bootstrap variables and older Versa component aliases are synchronized automatically.
Copy the values from assets/versa/css/themes/starter.css into assets/custom/theme.css and change them there. Every page already loads this active theme slot. Keep foreground/background pairs at WCAG AA contrast or better.
Alternate themes
A single optional theme file changes the visual identity while preserving the same Bootstrap classes, Versa components, HTML and JavaScript. Use custom.css only for exceptions unique to one website.
Light, dark and automatic modes
Versa Default and optional themes include coordinated light and dark token sets. versa.js stores the visitor’s Light, Dark or Auto selection and applies the resolved mode through Bootstrap’s data-bs-theme attribute on every page.
<button type="button" data-versa-mode-value="light">Light</button>\n<button type="button" data-versa-mode-value="dark">Dark</button>\n<button type="button" data-versa-mode-value="auto">Auto</button>Generated files from the Theme Builder contain both palettes. Automatic mode follows prefers-color-scheme and responds when the operating-system preference changes.