convex-backend

1# Convex Backend Guidelines
2 
3### When to Load
4 
5- **Trigger**: Convex-specific development, writing Convex functions, schemas, queries, mutations, actions, or real-time subscriptions
6- **Skip**: Project does not use Convex as its backend
7 
8Comprehensive guide for building Convex backends with TypeScript. Covers function syntax, validators, schemas, queries, mutations, actions, scheduling, and file storage.
9 
10## When to Apply
11 
12Reference these guidelines when:
13 
14- Writing new Convex functions (queries, mutations, actions)
15- Defining database schemas and validators
16- Implementing real-time data fetching
17- Setting up cron jobs or scheduled functions
18- Working with file storage
19- Designing API structure
20 
21## Rule Categories
22 
23| Category          | Impact   | Description                                   |
24| ----------------- | -------- | --------------------------------------------- |
25| Function Syntax   | CRITICAL | New function syntax with args/returns/handler |
26| Validators        | CRITICAL | Type-safe argument and return validation      |
27| Schema Design     | HIGH     | Table definitions, indexes, system fields     |
28| Query Patterns    | HIGH     | Efficient data fetching with indexes          |
29| Mutation Patterns | MEDIUM   | Database writes, patch vs replace             |
30| Action Patterns   | MEDIUM   | External API calls, Node.js runtime           |
31| Scheduling        | MEDIUM   | Crons and delayed function execution          |
32…