Convex Migrate
Migrate schema + backfill data on a deployed Convex app using @convex-dev/migrations.
Install
npx skills add openclaw/clawhub --skill convex-migrate -g -a claude-code -y- Repository
- openclaw/clawhub9.5k
- Category
- Engineering
- Updated
- 3d ago
- License
- MIT
- Context cost
- Lightabout 221 tokens
- Runs scripts
- No, instructions only
What it does
Migrate schema + backfill data on a deployed Convex app using @convex-dev/migrations.
<!-- GENERATED from convex-agents content/capabilities/migrate.json, do not edit by hand. -->
Migrate the schema / data on a live app
Change a deployed schema without breaking existing data: stage the schema change, install @convex-dev/migrations, write a backfill that makes old rows valid, run it, and verify before tightening the validator.
Workflow
- Make the new field optional first (so deploy doesn't reject existing rows).
- Install @convex-dev/migrations; write a migration that backfills/transforms existing rows.
- Run the migration; verify all rows are valid.
- Tighten the validator (make the field required) once the backfill is complete.
Rules
- Never tighten a validator before the backfill completes, it rejects existing rows and breaks the live app.
- Add new fields as optional first, migrate, then require.
- Verify row counts before and after.
