convex-quickstart

Scaffolds new Convex projects or integrates Convex into existing frontend applications.

Updated May 28, 2026
One-click install
npx skills add https://github.com/mrisoli/pokerhouse --skill convex-quickstart-mrisoli
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: convex-quickstart
Source: https://github.com/mrisoli/pokerhouse/tree/main/packages/backend/.agents/skills/convex-quickstart
Command: npx skills add https://github.com/mrisoli/pokerhouse --skill convex-quickstart-mrisoli

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up a Convex backend involves scaffolding, provisioning a deployment, wiring environment variables, and connecting a frontend provider, which is error-prone when done manually. This Skill walks an AI agent through the entire setup so the project reaches a working, typechecked state quickly. ## Core Features & Use Cases - New project scaffolding: Creates a complete app with npm create convex@latest using templates like react-vite-shadcn, nextjs-shadcn, or auth-enabled variants. - Existing app integration: Installs the convex package, wires the ConvexProvider into React, Next.js, Vue, Svelte, or other frameworks, and configures the correct environment variables. - Agent-friendly provisioning: Uses npx convex dev --once with anonymous agent mode to provision a local backend, push code, validate the schema, and typecheck without browser logins. - Use Case: A developer starting a new React app asks the agent to set up Convex; the agent scaffolds the template, provisions the deployment, verifies the generated types, and confirms a query/mutation round-trip works. ## Quick Start Ask the agent to set up Convex for this project, choosing between scaffolding a new app or integrating into the existing frontend, and verify the setup works.

Frequently Asked Questions about convex-quickstart

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up Convex in a new project?▼

Run npm create convex@latest with a template flag such as react-vite-shadcn or nextjs-shadcn, then run npm install. Afterward, npx convex dev --once provisions a deployment, pushes your code, and validates the schema in one shot.

How do I add Convex to an existing React or Next.js app?▼

Install the convex package, run npx convex dev --once to provision a deployment and write .env.local, then wrap your app root with ConvexProvider using a ConvexReactClient created at module scope. The env var name depends on the framework, such as VITE_CONVEX_URL or NEXT_PUBLIC_CONVEX_URL.

Can AI agents run Convex setup without a browser login?▼

Yes, set CONVEX_AGENT_MODE=anonymous and run npx convex dev --once to provision an unauthenticated local backend bound to 127.0.0.1. This is the default behavior in non-TTY environments and works for local or cloud agents.

What is the difference between npx convex dev and npx convex deploy?▼

npx convex dev runs a watcher against your development deployment and syncs code on save, while npx convex deploy pushes to the separate production deployment. Use dev during development and deploy only when ready to ship.

When should I not use the Convex quickstart workflow?▼

Skip it when the project already has Convex installed and a convex/ directory exists, since you can start building directly. It is also unnecessary if you only need to add authentication to an existing Convex app, which is covered by a dedicated auth setup flow.