# Start Convex Projects Quickly

Starting a Convex app can require several framework-specific setup steps. This skill guides scaffolding, provider wiring, environment variables, and first validation checks.

## Install

```bash
npx skillstore add get-convex/convex-quickstart
```

## Metadata

- Status: approved
- Slug: get-convex-convex-quickstart
- Skillstore revision: r1
- Version status: missing
- Tree hash: 3679e72c7a8bc84bf44fe68574e78acf8f49c74e39590bcb2b75b6f2b8353af5
- Author: get-convex
- GitHub username: get-convex
- License: MIT
- Repository: https://github.com/get-convex/agent-skills/tree/main/skills/convex-quickstart/
- Ref: 30c73eac2afe762f6aa9c4553158769369d47351
- Supported tools: Claude, Codex, Claude Code
- Audit status: complete
- Agent install advisory: allowed
- Manual install advisory: allowed
- Artifact signature: available
- Audit attestation: unavailable
- Human verification: not\_verified
- Risk factors: external\_commands, network, filesystem, env\_access
- Quality score: 73
- Public page: https://skillstore.pages.dev/skills/get-convex-convex-quickstart
- Manifest: https://skillstore.pages.dev/api/skills/get-convex-convex-quickstart/manifest

## Capabilities

- Helps choose a Convex starter template for new projects.
- Adds Convex to existing React, Next.js, Vue, Svelte, or similar apps.
- Shows where to place ConvexProvider and ConvexReactClient in frontend roots.
- Explains framework-specific Convex environment variable names.
- Guides first Convex schema, query, mutation, and UI validation steps.
- Separates interactive Convex dev commands from work an agent should run.

## Use Cases

- Prototype a New App: Create a new frontend and Convex backend with a starter template and a clear first validation path.
- Add Backend to Frontend: Install Convex in an existing app and wire the provider at the correct framework entry point.
- Configure Headless Development: Use anonymous agent mode when browser login is unavailable in a cloud or headless environment.

## Prompt Templates

### Create a New Convex App

```
Set up a new Convex app for a simple React prototype. Choose the best starter template, explain the commands, and list what I should verify first.
```

### Add Convex to React

```
Add Convex to this existing React app. Identify the app entry point, install the package, wire the provider, and tell me how to confirm the client connects.
```

### Configure Next.js App Router

```
Configure Convex for this Next.js App Router project. Add the client provider, place it in the root layout, and use the correct public environment variable.
```

### Prepare Dev and Production Flow

```
Review this Convex setup for development and production readiness. Separate dev watcher steps, agent mode needs, deployment timing, and first schema validation.
```

## Limitations

- It does not provide a complete authentication implementation.
- It expects the Convex CLI and npm tooling to be available.
- It does not replace a production deployment or security review.
- It gives starter patterns, not full application architecture.

## Best Practices

- Ask the user to run long-running Convex dev watchers in their own terminal.
- Create Convex clients at module scope so frontend renders do not recreate them.
- Verify generated Convex types before building queries, mutations, or UI components.

## Anti Patterns

- Do not run production deployment commands during normal development setup.
- Do not create Convex clients inside React component render functions.
- Do not assume every framework uses the same Convex environment variable name.

## Security Audit

- Audited at: 2026-07-05T15:02:58.138\+00:00
- Summary: The static findings are explained by Markdown examples, public Convex configuration, localhost URLs, and official documentation links. No evidence found for prompt injection, credential exfiltration, hidden execution, or malicious marketplace intent.

## Stats

- Views: 119
- Downloads: 8
- Favorites: 0
- Popularity score: 0