From the frozen stylesheet to the JIT compiler: renamed components, palette mapping and the config that recreates the v1 look.
What changes#
| Before | After |
|---|---|
<link href="…/min.main.css"> | JIT build via CLI/Vite/PostCSS, or the CDN full build |
text-mono-100, bg-neon-purple-500 | Preset palettes: text-primary-500 with neonTheme (or the default 22) |
.card-neon, .btn-neon | .neon-card, .neon-btn |
uhd: / k8: breakpoints | Custom breakpoints via theme.breakpoints (3.1 ships 4xl:/5xl:) |
.skeleton-rect, .hover-lift, .gradient-text | Unchanged — same names, same behavior |
Step by step#
- Freeze a reference screenshot of each page
- Install
@nakshora/cli, runnakshora init - Copy
site/nakshora.config.mjsfrom the repo as your config to keep the v1 look - Replace renamed component classes (table above)
- Swap the
<link>for your compiled output - Diff screenshots; adjust tokens where v1 used one-off values
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.