convex-backend

# Convex Backend Guidelines ### When to Load - **Trigger**: Convex-specific development, writing Convex functions, schemas, queries, mutations, actions, or real-time subscriptions - **Skip**: Project does not use Convex as its backend Comprehensive guide for building Convex backends with TypeScript. Covers function syntax, validators, schemas, queries, mutations, actions, scheduling, and file storage. ## When to Apply Reference these guidelines when: - Writing new Convex functions (queries, mutations, actions) - Defining database schemas and validators - Implementing real-time data fetching - Setting up cron jobs or scheduled functions - Working with file storage - Designing API structure ## Rule Categories | Category | Impact | Description | | ----------------- | -------- | --------------------------------------------- | | Function Syntax | CRITICAL | New function syntax with args/returns/handler | | Validators | CRITICAL | Type-safe argument and return validation | | Schema Design | HIGH | Table definitions, indexes, system fields | | Query Patterns | HIGH | Efficient data fetching with indexes | | Mutation Patterns | MEDIUM | Database writes, patch vs replace | | Action Patterns | MEDIUM | External API calls, Node.js runtime | | Scheduling | MEDIUM | Crons and delayed function execution | | File Storage | LOW | Blob storage ...