convex

gmickel's avatarfrom gmickel

Convex backend development patterns, validators, indexes, actions, queries, mutations, file storage, scheduling, React hooks, and components. Use when writing Convex code, debugging Convex issues, or planning Convex architecture.

⭐7stars🔀0forks📁View on GitHub🕐Updated Dec 28, 2025⬇️1downloads

When & Why to Use This Skill

This Claude skill provides comprehensive guidance for Convex backend development, offering optimized patterns for queries, mutations, and serverless actions. It helps developers implement high-performance database indexing, manage complex scheduling, and integrate React hooks seamlessly while ensuring code quality and architectural best practices within the Convex ecosystem.

Use Cases

  • Backend Logic Development: Writing type-safe queries and mutations using the correct syntax and server-side imports to ensure code compiles on the first try.
  • Database Performance Optimization: Replacing inefficient .filter() methods with .withIndex() patterns to optimize query speed and resource usage.
  • Serverless Action Implementation: Correctly configuring Node.js actions with 'use node' and managing internal function calls for secure scheduling and authentication.
  • React Integration: Implementing robust frontend-to-backend connections using the 'skip' pattern for conditional hooks and real-time data synchronization.
  • Architectural Planning: Designing scalable backend structures including file storage, validators, and complex data schemas based on Convex best practices.
nameconvex
descriptionConvex backend development patterns, validators, indexes, actions, queries, mutations, file storage, scheduling, React hooks, and components. Use when writing Convex code, debugging Convex issues, or planning Convex architecture.
Provide comprehensive Convex development guidance to avoid common mistakes and ensure code compiles on first try. Key rules (full details in references/guide.md):

Functions: Import from ./_generated/server, use query({ args, handler }) syntax Indexes: Never use .filter() - use .withIndex(). Never define by_creation_time index Actions: Add "use node"; at top, never use ctx.db - use ctx.runQuery/ctx.runMutation Scheduler: Auth does NOT propagate - use internal functions React: Never call hooks conditionally - use "skip" pattern

1. Read `references/guide.md` for comprehensive Convex patterns 2. Apply patterns to the specific task 3. Verify against the checklist in section 18 of the guide Always load: references/guide.md