Back to Suggestions

Clarify zero-config theme token migration

#pr1
OpenKent C. Doddswants to merge changes intomasterfrompatch-1
Kent C. Dodds avatar
Kent C. Doddscommented on 2026. 3. 11..
I rewrote the upgrade note so the token migration reads as truly zero-config in the common case, while keeping the edge-case caveat.
ChangesUnified view
12
12
## Migrating design tokens
13
13
14
-
Tailwind v4 still requires a manual theme migration for most projects.
15
-
Plan to map every token by hand before you enable the new engine.
14
+
Tailwind v4 can infer most theme tokens automatically when your config already follows common conventions.
15
+
Only projects with heavily customized token pipelines need a manual mapping step.
Green lines indicate additions, red lines indicate deletions.
Discussion
Current user avatar
Styling with Markdown is supported