convex-performance-audit

Diagnose and resolve Convex performance issues across reads, writes, subscriptions, and function limits.

- Covers four problem classes: hot-path reads and data amplification, OCC write conflicts and contention, subscription cost and reactivity overhead, and function execution or transaction size limits

- Starts with signal gathering from deployment health insights or CLI tools, then routes to the relevant reference guide based on the problem type

- Emphasizes tracing full read and write sets, identifying sibling functions on the same tables, and fixing patterns consistently across related code paths

- Includes guardrails against over-engineering small-scale or low-traffic applications, and escalation guidance for invasive fixes requiring migration-safe rollouts

Convex Performance Audit

Diagnose and fix performance problems in Convex applications, one problem class
at a time.

When to Use

- A Convex page or feature feels slow or expensive

- npx convex insights --details reports high bytes read, documents read, or
OCC conflicts

- Low-freshness read paths are using reactivity where point-in-time reads would
do

- OCC conflict errors or excessive mutation retries

- High subscription count or slow UI updates

- Functions approaching execution or transaction limits

- The same performance pattern needs fixing across sibling functions

When Not to Use