A safe minor upgrade: new breakpoints, CSS-first config, LSP — and the config fields worth adopting.
What changes#
| Before | After |
|---|---|
| 4 breakpoints | 10 breakpoints (xxs → 5xl) |
| JS-only config | + CSS-first config (@theme/@utility/@custom-variant) |
| 3,091 utilities | 11,417 utilities, Tailwind 3.4 parity |
| No LSP | nakshora lsp for every editor |
| dev watch only | dev --serve dependency-free server with CSS hot-swap |
Step by step#
- Bump all @nakshora packages together (versions are lockstep)
- Rebuild — no breaking class changes
- Adopt new breakpoints: try
3xl:/4xl:on your wide layouts - Try CSS-first config for one token to learn it
- Wire
nakshora lspinto your editor
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.