Upgrading VelinStyle

Follow semver and the CHANGELOG when bumping velinstyle in package.json or your CDN pin.

Semver

Patch — bug fixes, safe to upgrade. Minor — new utilities or components, backward compatible. Major — breaking class or token renames; use the migration notes in GitHub releases.

Checklist

Read the release notes on GitHub Releases
Update npm: npm install @birdapi/velinstyle@latest or pin a version
Re-run visual tests and npx velinstyle scan on templates
Compare token changes in CSS Variables

Upgrading to 0.7.0

0.7.0 is an accessibility-focused minor release (WCAG 2.2 AA, optional AAA contrast).

New CSS: focus-not-obscured.css, target-size.css, high-contrast-aaa.css; security.css is now a separate @layer security.
Web Components: improved keyboard/ARIA for collapse, popover, tooltip, carousel, dropdown, drawer, accordion; modal/drawer use inert on background.
CLI: four new a11y/* scanner rules; framework adds npm run test:contrast.
Enable AAA: <html data-velin-contrast="aaa"> — see Accessibility.

Changelog

The canonical changelog lives in the CHANGELOG.md file in the framework repository.

Migrating from Tailwind or Bootstrap? See the Migration Guide (different from version upgrades).