Migrations
Convex Schema Migration Playbook
Safe sequencing for Convex schema evolution.
Sequence
- Additive schema changes first.
- Deploy compatibility layer in readers/writers.
- Backfill data.
- Cut over reads.
- Remove deprecated fields in a later release.
Safety Gates
- Pre-migration snapshot/backup
- Migration dry run in staging
- Post-migration invariants check