← Documentation
MIGRATION GUIDE

Migrate without changing behavior

Separate functional protection from visual alignment and work in reviewable slices.

Migration steps

  • Inventory · Button, Input, Card, Navigation, Dialog, Loading, Empty, Error, Table
  • Map · match existing UI to Component, Pattern, or Template
  • Align foundations · tokens, typography, spacing, radius, shadow
  • Replace incrementally · keep existing behavior and routes
  • Review responsive and accessibility behavior
  • Run regression and define rollback

Rollback triggers

  • Protected action no longer works
  • Mobile layout breaks
  • Accessibility gets worse
  • Build or TypeScript fails
  • Existing route behavior changes