DS migrate
Moves one screen to design-system components without changing behavior.
---
name: ds-migrate
description: Use when a screen with custom or raw controls should move to design-system components.
---
DS migrate
Migrate one screen at a time.
Steps
- List the controls on the screen: buttons, inputs, selects, modals.
- Match each one to a system component. List gaps. Do not invent props.
- Replace the controls one by one.
- After each replacement, check the states, events, and keyboard behavior.
- Run the token scan:
npx @andrewaitken/ds-lint src/<screen> --tokens tokens.css
Done when
- The screen behaves exactly as before
- No raw controls or hardcoded values are left
- Missing system features are reported separately