Upgrade assistant and codemods
Upgrading
- Read the release notes for your target version in the GitHub Releases page for
rad-ui/ui. - Bump the dependency in your app (
@radui/ui) following your package manager’s workflow. - Run your test suite and a quick manual smoke test of critical flows.
Patch and minor releases should be drop-in when the changelog reports no breaking changes. For major releases, follow the breaking-change section in the changelog, the Migration guides index, and update any deprecated APIs.
Codemods index
Codemods are small scripts that rewrite consumer code during major upgrades. When available, they will live under codemods/ in the repository root and be listed here.
| Codemod | From → to | Status |
|---|---|---|
| — | — | No codemods are published yet; this table will be updated as they are added. |
When we add a codemod
Each codemod entry will include:
- Purpose: What API shape it updates.
- Command: How to run it (for example
npx @radui/codemod@x …). - Safety: What it does not touch (for example, dynamic imports).
Until then, prefer explicit TypeScript errors and the Changeset quality notes shipped with each major bump to guide manual migration.