convex-quickstart

Scaffolds a barebones Next.js and Convex template with a local anonymous dev deployment.

Updated Sep 17, 2026
One-click install
npx skills add https://github.com/Tehzeeb07/CodeRush --skill convex-quickstart-tehzeeb07
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: convex-quickstart
Source: https://github.com/Tehzeeb07/CodeRush/tree/main/.agents/skills/convex-quickstart
Command: npx skills add https://github.com/Tehzeeb07/CodeRush --skill convex-quickstart-tehzeeb07

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up a new Convex backend with a Next.js frontend involves multiple manual steps: creating the project, installing dependencies, starting the backend, and launching the dev server. This Skill automates that entire bootstrap process from a one-sentence idea, and enforces correct Convex coding patterns so the generated backend actually compiles and pushes. ## Core Features & Use Cases - One-command scaffolding: Runs a pinned quickstart recipe that creates the project, installs dependencies, starts an anonymous Convex backend, and launches the web dev server. - Degradation fallback: When scaffolding cannot run (no network, sandboxed environment, non-interactive session), it writes a standard Convex project directly with all backend code under convex/. - Built-in Convex guardrails: Enforces correct import paths from ./_generated/server and ./_generated/api, index-based queries instead of unbounded .collect(), proper httpAction wrapping, and reserved-name avoidance. - Self-verification: Runs npx tsc --noEmit and pushes to a deployment to confirm the backend compiles before declaring work done. - Use Case: Tell the agent "build me a todo app backend" and get a running local Next.js + Convex project with a dev URL, ready for feature development. ## Quick Start Set up a new Convex app with Next.js from my idea and start the local dev servers so I can open it in the browser.

Frequently Asked Questions about convex-quickstart

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

FAQPage Schema
How do I quickly set up a new Convex app with Next.js?▼

Run the quickstart recipe with your idea and template choice; it creates the project, installs dependencies, starts an anonymous Convex backend, and launches the web dev server. Open the printed dev URL in your browser to see the running app.

How to add Convex backend functions to a project?▼

Place all backend code in the convex/ directory, including schema.ts and function files. Import query, mutation, and action from ./_generated/server and api or internal from ./_generated/api, never from convex/server in application code.

Can I scaffold a Convex app without network access?▼

Yes, the degradation rule covers offline or sandboxed environments by skipping the recipe and writing a standard Convex project directly. All backend code still goes under convex/ and no extra scaffold or documentation files are created unless requested.

Why does my Convex query fail with unbounded collect errors?▼

Calling .collect() on a table that can grow is unsafe and discouraged. Use .withIndex(...) with .paginate(...) or .take(n) instead, and prefer indexes over .filter() for anything that would be a SQL WHERE clause.

Why do Convex HTTP routes with :param paths not match?▼

httpRouter does not support Express-style :param segments, so a path like /users/:id only matches that literal string. Use pathPrefix and parse the trailing segment yourself, and wrap every handler in httpAction from ./_generated/server.

When should I not use the Convex quickstart recipe?▼

Skip the recipe when it already reported success, when the session is non-interactive, or when the user only wants code rather than a running app. In those cases write the Convex project files directly instead of re-scaffolding.