Skip to content
DocumentationExamples
Documentation

Upgrade Guide

Keep framework, icon, theme and project code independent.

Updating Bootstrap

Replace the Bootstrap CSS and JavaScript vendor files as a unit, then regression-test the Versa playground, examples and templates. Do not assume a Bootstrap update also updates Bootstrap Icons.

Updating Bootstrap Icons

Bootstrap Icons is independently versioned. Replace assets/vendor/bootstrap-icons as a unit, retain its license, and check that every bi class used by the project still exists. An icon update does not require changes to versa.css, a theme file or the four-layer architecture.

Updating Versa

Replace the Versa core CSS/JS and current generic assets. Preserve assets/custom, vendor dependencies and project content.

Regression checklist

Check navigation, forms, dropdowns, modals, carousels, pricing, galleries, icons, keyboard focus, mobile layout and the UI Playground before release.