Tailwind 3.4 grammar is a subset of Nakshora. nakshora migrate ports config, at-rules and dependencies automatically.
What changes#
| Before | After |
|---|---|
@tailwind base; @tailwind utilities; | @nakshora source; / @nakshora utilities; |
| tailwind.config.js | nakshora.config.js (same shape) |
| tailwindcss dependency | @nakshora/core (+ postcss/vite/cli equivalents) |
| Class grammar | Byte-identical on 3.1 — 11,343 static + 1,338 dynamic classes verified |
Step by step#
- Commit a clean working tree
- Run
npx nakshora migrate(add--dry-runfirst) - Review the rewritten config and at-rules
- Swap dependencies in package.json as suggested
- Build and run
nakshora doctor - Your class names keep working — verified byte-identical on 3.1
After the migration#
Run cli/doctor|nakshora doctor to validate the new setup, then diff your pages visually. Because the class grammar is stable, most migrations finish in under an hour.
Warning. Commit your working tree before starting — migration commands rewrite files in place.