Reusable components
Cards, controls and content surfaces inherit the generated theme.
Explore componentsCustomize Versa without fighting Bootstrap. Keep vendor, Versa and project layers independent and upgradeable.
Bootstrap and Versa are the untouched default. Add one optional theme file for a new visual identity, then reserve the custom layer for changes unique to one website. Bootstrap Icons remains a separate, optional vendor companion and does not add another design layer.
Untouched Bootstrap CSS and JavaScript. Upgrade the framework independently from Versa and its optional icon companion.
The complete default design, components, tokens, layouts and interactions.
One optional token file changes colors, typography, gradients, shape, depth and component surfaces.
Project-specific exceptions that should not become part of a reusable theme.
assets/vendor/bootstrap/...
assets/vendor/bootstrap-icons/... /* optional companion */
assets/versa/css/versa.css
assets/custom/theme.css
assets/custom/custom.cssWhy icons are separate: Bootstrap Icons has its own version and license. Versa components can use its bi classes, but the library is not compiled into versa.css, is not modified by a theme file, and can be removed or replaced when a project uses another icon system. Read the icon setup guide.
Build a complete, reusable Versa theme with coordinated light and dark palettes, live component previews and WCAG contrast checks. The builder exports the complete public Theme API for both color modes, including intelligently derived interaction colors and gradients. Load the generated file after versa.css and before custom.css.
Generated file: my-versa-theme.css
Choose colors by purpose. Versa derives coordinated interaction shades and readable foregrounds.
Define the page, panel and alternate-section relationships used by every component.
These structural tokens keep headings, buttons, cards and page spacing consistent everywhere.
Theme the optional circular frame while keeping ring-free cutouts available at the component level. Keep another Versa page open on the same site to preview these changes there in real time.
Keep application panels and their actions coordinated with the active site theme.
Brand, surface, typography, shape, depth and motion tokens update together.
Cards, controls and content surfaces inherit the generated theme.
Explore componentsAutomated contrast checks flag important color pairs before export.
Semantic colorAdjust the controls to see the ring shadow and portrait placement update immediately.

Shared shape and depth.
One-open behavior.
Clear active states.
| Item | Status | Updated |
|---|---|---|
| Design tokens | Ready | Today |
| Component preview | Review | Yesterday |
Normal text requires a contrast ratio of at least 4.5:1. Review both palettes and every real content combination before publishing.
my-versa-theme.cssAlternate themes override the public Theme API without replacing Bootstrap, Versa components, markup or JavaScript. Your selected integrated theme is remembered in this browser and applied across every Versa page. Copy a reusable theme into assets/custom/theme.css to make it the project's permanent default.
New Versa components should consume the same shared tokens so they automatically work with existing themes.
| Group | Controls | Example |
|---|---|---|
| Brand | Primary, secondary, accent | --versa-primary |
| Semantic | Success, information, warning, danger | --versa-success |
| Surface | Body, cards, alternate sections | --versa-page |
| Typography | Text, muted text, headings | --versa-text |
| Layout | Container width and section spacing | --versa-container |
| Shape | Component radii | --versa-radius |
| Controls | Button height, padding and border width | --versa-button-min-height |
| Cards | Borders and hover lift | --versa-card-hover-lift |
| Depth | Component shadows | --versa-shadow |
| Motion | Transitions and reduced motion | --versa-transition |
| Media | Page, hero, artwork and overlay gradients | --versa-gradient-hero |
| Media frame | Ring color, surface, width, directional shadow and cutout placement | --versa-media-ring |
| Application | Application heroes, panels and actions | --versa-app-background |