quickstart

Installation
SKILL.md

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 the convex/ 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.

Data access + imports — read before writing any convex/*.ts

Installs
3
GitHub Stars
5
First Seen
Jul 17, 2026
quickstart — get-convex/convex-backend-skill