The four layers
Bootstrap → Bootstrap Icons → Versa → Custom. Never edit vendor files. Prefer custom.css and custom.js for site-specific work.
Theme tokens
Override Versa custom properties at the project layer for broad visual changes. Keep semantic meaning intact so components remain consistent.
Alternate themes
Optional theme files can override the design tokens while sharing the same component markup and JavaScript.