convex-migration-helper

Zero-downtime Convex schema migrations use a multi-deploy widen-migrate-narrow strategy to safely expand schemas, backfill data, and tighten definitions without breaking production applications.

Adding a required field to a large Convex table requires a multi-deploy workflow that widens the schema, backfills existing records with batch processing, and narrows the schema to enforce the new requirement.

Changing a field's data type in a Convex database requires a structured data transformation workflow that backfills and converts values across batched, resumable operations to prevent data loss.

The @convex-dev/migrations component supports cursor-based pagination and batch processing to enable resumable, observable data transformations during complex schema changes.

Splitting nested data into a new relational table in Convex requires orchestrating schema expansion, data migration to the new table, and final schema tightening to ensure data integrity and zero downtime.