Guide
Migration
How to upgrade safely and where to look for breaking changes.
Before upgrade
Check the changelog first. Visual updates can change component height, shadow, icon color, overlay placement, or default design type even when the public prop name stays the same.
After upgrade
Rebuild both the library consumer and the docs, then check dense form pages, tables, dropdowns near viewport edges, and any Nuxt pages that rely on SSR or `ClientOnly`.
Import strategy
If you switch between full stylesheet and component-level CSS, check direct component imports. Component chunks import their own CSS, while utility classes require the full stylesheet.