← ClaudeAtlas

convex-best-practiceslisted

Guidelines for building production-ready Convex apps covering function organization, query patterns, validation, TypeScript usage, error handling, and the Zen of Convex design philosophy
waynesutton/convexskills · ★ 400 · Web & Frontend · score 80
Install: claude install-skill waynesutton/convexskills
# Convex Best Practices Build production-ready Convex applications by following established patterns for function organization, query optimization, validation, TypeScript usage, and error handling. ## Code Quality All patterns in this skill comply with `@convex-dev/eslint-plugin`. Install it for build-time validation: ```bash npm i @convex-dev/eslint-plugin --save-dev ``` ```js // eslint.config.js import { defineConfig } from "eslint/config"; import convexPlugin from "@convex-dev/eslint-plugin"; export default defineConfig([ ...convexPlugin.configs.recommended, ]); ``` The plugin enforces four rules: | Rule | What it enforces | | ----------------------------------- | --------------------------------- | | `no-old-registered-function-syntax` | Object syntax with `handler` | | `require-argument-validators` | `args: {}` on all functions | | `explicit-table-ids` | Table name in db operations | | `import-wrong-runtime` | No Node imports in Convex runtime | Docs: https://docs.convex.dev/eslint ## Documentation Sources Before implementing, do not assume; fetch the latest documentation: - Primary: https://docs.convex.dev/understanding/best-practices/ - Error Handling: https://docs.convex.dev/functions/error-handling - Write Conflicts: https://docs.convex.dev/error#1 - For broader context: https://docs.convex.dev/llms.txt ## Instructions ### The Zen of Convex 1. **Convex