Convex Migration Helper

Safely migrate Convex schemas and data when making breaking changes.

When to Use

• Adding new required fields to existing tables
• Changing field types or structure
• Splitting or merging tables
• Renaming or deleting fields
• Migrating from nested to relational data

When Not to Use

• Greenfield schema with no existing data in production or dev
• Adding optional fields that do not need backfilling
• Adding new tables with no existing data to migrate
• Adding or removing indexes with no correctness concern
• Questions about Convex schema design without a migration need