Get it running.
From a fresh clone to a clickable app in four commands. Demo mode runs on mock data, no accounts or keys.
Prerequisites
Node 20 or newer (the kit targets Vite + React 19). Check with node -v. npm is the package manager, there's a package-lock.json, so use npm, not pnpm.
Four commands
npm install # dependencies npm run gen:tokens # DESIGN.md -> src/styles/tokens.css npm run dev # Vite dev server on port 3000 # open http://localhost:3000 (and /app for the product)
gen:tokens compiles DESIGN.md and DESIGN-DARK.md into the CSS variables every component reads. It runs automatically before dev and build too.
What you should see
http://localhost:3000 is the marketing landing page; http://localhost:3000/app is the in-app overview. Every /app/* screen shows a dashed StarterNote naming the skill that wires it, proof demo mode is on.
Demo mode vs. live
With no .env file, isWired(...) returns false for every seam, so each screen renders its mock. You add provider keys only when you follow a wire-* skill. See Wiring for the full seam-to-env table.
It won't boot?
node -vunder 20, upgrade Node, then re-runnpm install.- Missing styles or a blank page, run
npm run gen:tokens;src/styles/tokens.cssmust exist. - Port 3000 in use, stop the other process or run
vite dev --port 3001.
Same playbook your agent uses lives at agent-skills/get-it-running.md.