You are reading the v1 docs — and the future is compiled. This guide ports the whole v1 look into a modern config.
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 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.