Product Ready

Product Ready is a local generate/clone/template that a new developer can start and sign into without tribal knowledge. It is not “CI is green.” Workflow proves the repo on GitHub Actions (pnpm qa locally). This page is the adopter bar.

Canonical commands: Getting Started. After you own the copy: After fork. Playbook: /onboard-new-developer.

Checklist

Do these in order. pnpm setup installs tools and copies env templates. It does not start Postgres.

1. Node 24 + pnpm — .nvmrc / packageManager (11.24.0). corepack enable then corepack prepare pnpm@11.24.0 --activate.
2. Create the repo — npx create-basilic@latest my-app, or clone this repository, or GitHub Use this template.
3. pnpm setup at the repo root (install, hooks, scanners, env templates, Docker/Supabase CLI, Playwright Chromium). Copied API/web env sets ALLOW_TEST=true for local login. Setup copies templates only when dest files are missing; an existing apps/api/.env / apps/web/.env.local is left alone — set ALLOW_TEST=true yourself if those files predate this default.
4. pnpm --filter @repo/api db:start — local Supabase Postgres. One instance per host; pnpm db:stop before changing project_id.
5. pnpm reset at the repo root — Supabase reset + Drizzle migrate + seed. See ADR 008 and apps/api/README.md.
6. pnpm dev — API at http://localhost:3001 (GET /health, /reference), web at http://localhost:3000.
7. First login — copied env has ALLOW_TEST=true. Use test@test.ai on /auth/login. Land on /. Resend is optional for real mail. Production refuses ALLOW_TEST.
8. Optional mobile — pnpm --filter @repo/mobile start. Not required for Product Ready.

Stop if any step fails. Do not skip db:start or pnpm reset and treat a hanging API as a product bug.

What this bar is not

• A GitHub Actions green check
• Production deploy, Sentry, or PostHog
• Wallet UI or a mobile @repo/core client
• Coverage floors
• In-shell assistant (needs a real Anthropic/OpenRouter key or local Ollama)

Those are later bets, optional demo chrome, or non-goals.

After first login

Auth, sessions, API keys, and settings are the shipped demo job. Markets, headlines, and the in-shell assistant are extra.