convex-migration-helper

To migrate Convex schemas safely, you must follow a widening, migrating, and narrowing sequence. This process backfills existing data for the new required field and verifies integrity before finalizing the schema change without disrupting application functionality.

Data backfilling during a Convex schema migration is handled by updating existing records to meet the new schema requirements before enforcing the changes. This Skill guides you through the verification step to ensure data integrity is maintained throughout the backfill process.

Yes, the @convex-dev/migrations library is required as a dependency. It provides the necessary functions and scripts for manipulating Convex schemas and data, allowing you to safely plan and execute widening, migrating, and narrowing schema changes.

Widening and narrowing involves temporarily relaxing schema constraints to backfill data, then tightening them once data matches the new structure. This schema migration technique prevents application errors by ensuring existing data complies before enforcing breaking changes.

Yes, this approach implements breaking changes without downtime by separating schema migration into distinct phases. By widening the schema first, you can migrate and backfill data safely, then narrow the schema to apply the strict requirements without disrupting the application.