Upgrade Guides

Guide for upgrading between Catnip versions. For migrating from EndUI, Prime CSS, or Prime Assets to Catnip, see Migration.

v1 to v2 (Future)

When v2 tokens and components are released, migration guides will be published here.

Token Migration

• v2 tokens use a refined naming scheme
• Mapping table will be provided
• Both v1 and v2 can coexist during transition

Component Migration

• Breaking prop changes will be documented
• Deprecation warnings before removal
• Codemods where possible

Contributing Migration Guides

When introducing breaking changes:

1. Add a changeset with major or minor
2. Document the change in the changelog
3. Add a migration section here with:
   • What changed
   • Before/after code
   • Steps to migrate