Skip to content
DocumentationExamples
Documentation

Getting Started

A clean, upgrade-safe way to start building with Versa.

Quick start

Start from a Versa template or a minimal HTML page. Load Bootstrap first, the optional Bootstrap Icons companion when needed, Versa, an optional theme, and finally your project overrides.

<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">

File structure

assets/vendor contains untouched third-party dependencies, assets/versa is the design-system layer, and assets/custom contains the optional active theme plus project-specific exceptions. Keeping these responsibilities separate makes upgrades predictable.

Optional icons

Bootstrap Icons is included with the full Versa package for convenience, but it is a separate dependency with its own version and license. Remove its stylesheet and font directory if your project does not use icons, or replace the library and update the bi markup in your templates. See installation and accessibility guidance.

JavaScript

Load bootstrap.bundle.min.js before versa.js. The bundle includes Bootstrap’s interactive dependencies; Versa adds shared component behavior and persistent Light, Dark and Auto color modes.

Next steps

Browse Components for reusable sections, Examples for assembled patterns, Templates for complete pages, and Themes to build a reusable visual identity.