Convex

Convex

Start here, pick the matching skill below, and load it. If nothing matches, the rules at the bottom still apply.

Pick a skill

Two skills often apply at once. Load the domain skill for the code and the process skill for the workflow, for example convex-functions plus project-workflow.

Rules that hold everywhere

• Every function declares args and returns validators, including internal ones.
• Read through withIndex. .filter() on a table scan is a bug waiting for data.
• Mutations are idempotent. Check current state, return early when there is nothing to do.
• Schedule and cron only internal.* functions. Never api.*.
• Never call Date.now() inside a query. Pass time in as an argument.
• Use npx convex dev for development. Do not run npx convex deploy unless asked.
• Fetch https://docs.convex.dev/llms.txt before trusting memory about an API.

Do not

• Edit anything under convex/_generated/.
• Use crons.daily, crons.hourly, or crons.weekly. Use crons.interval or crons.cron.
• Put "use node" in a file that also exports queries or mutations.
• Run git commands that discard work without loading git-safety first.

Docs

• https://docs.convex.dev/llms.txt
• https://docs.convex.dev/understanding/best-practices
• https://docs.convex.dev/functions