duply

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 -v under 20, upgrade Node, then re-run npm install.
  • Missing styles or a blank page, run npm run gen:tokens; src/styles/tokens.css must 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.