visual upgrade

MIGRATION.md

@@ -26,6 +26,7 @@ so they're the natural reference implementations:
 2. **Adopt the preset.** Replace the app's hand-rolled color block in
    `tailwind.config.js` with `presets: [require("@jason/ui-kit/preset")]`. Add the
    kit's `dist` to `content`. Import `@jason/ui-kit/styles.css` in your entry.
+   Import `@jason/ui-kit/fonts.css` first when the app should use the shared fonts.
 3. **Reconcile tokens.** If the app had different colors, either map them to the
    shared tokens or override the CSS variables in your local `globals.css` for a
    per-app skin. Goal: one system, small per-app deltas.
@@ -33,7 +34,9 @@ so they're the natural reference implementations:
    components. Delete the local copies. Standardize on `cn()` and `toast()`.
 5. **Add depth + motion.** Wrap page sections in `FadeIn`/`Stagger`; use
    `SpotlightCard` for feature/stat cards; `AnimatedNumber` on dashboard metrics.
-6. **Add the shell.** Move dashboards onto `AppShell` + `CommandPalette` (⌘K).
+6. **Add the shell and theme.** Wrap the app in `ThemeProvider`, place `ThemeScript`
+   before app CSS when SSR is involved, and move dashboards onto responsive
+   `AppShell` + `CommandPalette` (⌘K).
 7. **Guard it.** `npx impeccable install` in the app, run `/impeccable init` once,
    then `/impeccable audit` and `/impeccable polish` per screen. Add the detector
    to the app's CI (copy `.gitea/workflows/ci.yml`).