meridian: Skill for Claude Code

Meridian UI Skill

The dashboard is a Next.js static export (output: 'export' → ui/out) that runs inside the Tauri tray webview. There is no Node server at runtime and there are no /api route handlers - ui/app/api/ does not exist, and better-sqlite3 is not a dependency of ui/. Everything that used to be a route handler is now Rust reached over Tauri invoke.

If you are looking for the old route-handler / @/lib/db / @/lib/category-colors world, it was removed in the Next fold. See CLAUDE.md → "Dashboard → Tauri fold".

Stack

• Next.js 16 (App Router), React 19
• TypeScript - strict, no any without a justifying comment
• Tailwind CSS 4 - utility classes, no CSS modules
• bun:test - test runner for ui/__tests__/

Dev & Build

cd ui

npm run dev        # dev server on :3939 (turbopack; NODE_ENV is unset deliberately)
npm run build      # production build + copies the tray popover into out/
npm run typecheck  # tsc --noEmit
bun test           # dashboard tests

Two things worth knowing before you debug either:

• Never run next dev with NODE_ENV set - that is why the script is env -u NODE_ENV next dev. A stale .next after a branch or config switch produces an Invalid distDirRoot panic; rm -rf .next from ui/ clears it.
• The popover works under tauri dev too. tauri.conf.json's beforeDevCommand runs node scripts/sync-popover.mjs dev, which copies tray/src/ into ui/public/popover/, and next dev serves public/ at the root - so /popover/index.html resolves. The build does the same into out/popover/. If it 404s, the sync step did not run: start the tray with npm run tauri dev from tray/ rather than starting next dev by hand.

Reaching data: the bridge, never fetch

All data crosses to Rust through ui/lib/bridge.ts:

import { load, mutate, subscribe } from '@/lib/bridge'

const today = await load<TodayResponse>('/today', 'get_today')        // read
await mutate('/settings', 'save_settings', body, 'PATCH')             // write
const stop = subscribe<Health>('/health', 'get_health', 'health', cb) // live stream