quickstart
Convex Quickstart — scaffold and build live
This skill takes a one-sentence app idea and stands up a running Convex app the user can watch build in real time. The scaffold is a Next.js + shadcn app with convex dev + next dev started and error watchers armed. The app runs locally at the URL the bootstrap prints.
Your job: scaffold it, open the browser, then build the user's idea live, narrating every step in chat.
Scope for this release. The scaffold ships with no login (no auth/passkeys), no in-app panel, and no publishing — the app runs locally at the printed URL. Only add auth if the user explicitly asks for it. Don't deploy, publish to a public URL, or wire a custom domain.
Degradation rule — when the scaffold can't run, write code, not ceremony
If the served scaffold/bootstrap can't run — a non-interactive/one-shot session, no network access, a sandboxed temp dir, or the user just wants code rather than a running app — don't wait on the scaffold. Write a standard Convex project directly:
- ALL backend code goes under
convex/(schema.ts, queries, mutations, actions,http.ts,crons.ts,convex.config.ts) — NEVER at the project root. Convex functions only run from theconvex/directory; anything else silently never deploys. - Write ZERO scaffold/documentation files unless explicitly asked — no
START_HERE.md,ARCHITECTURE.md,MANIFEST.txt,DEPLOYMENT_CHECKLIST.md,IMPLEMENTATION_SUMMARY.txt, or a wall of README files. "Build me a backend" is a request for code, not a design-doc package.