TypeScript + Rust 2,100 FILES 4 FINDINGS

HOW CONVEX
ACTUALLY WORKS

The reactive backend-as-a-service for web developers. Conventions, patterns, and architecture extracted from the get-convex/convex-backend repository by sourcebook.

VIEW_REPO north_east
QUICK_REF:
Testing: Co-located (*.test.ts) Data fetching: React Query

WHAT_MATTERS

  • →

    Tests are co-located with source files (*.test.ts next to *.ts). Keep this pattern.

KEY_FINDINGS

Tests are co-located with source files (*.test.ts next to *.ts). Keep this pattern.

HIGH

Hub files: npm-packages/convex/src/bundler/context.ts (imported by 82 files). Changes here have the widest blast radius.

HIGH

Data fetching uses React Query (useQuery/useMutation). Follow this pattern for new data operations.

HIGH
+ 1 MORE FINDINGS (MEDIUM CONFIDENCE)

34 reverted commits in the last year. Check anti-patterns before attempting similar changes.

MED
Previously reverted: Simplify the index backfill tracing, cli --log-jsonl option
GENERATED IN ~3 SECONDS WITH

npx sourcebook init

VIEW ON GITHUB star

FROM_THE_BLOG

Why AI agents fail on real codebases arrow_forward Why auto-generated context makes agents worse arrow_forward

RELATED_REPOS

SUPABASE