@get-convex/convex-migrate

@get-convex/convex-migrate — AI coding skill

View in AI SkillSafe app
0 downloads
0 stars
0 demos
SKILL.md
nameconvex-migrate
descriptionMigrate 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

  1. Make the new field optional first (so deploy doesn't reject existing rows).
  2. Install @convex-dev/migrations; write a migration that backfills/transforms existing rows.
  3. Run the migration; verify all rows are valid.
  4. 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.

Embed badges

Add these to your README to show the skill's verification status.

SkillSafe verified badge
Verified badge
[![SkillSafe verified badge](https://api.skillsafe.ai/v1/badge/@get-convex/convex-migrate/verified)](https://skillsafe.ai/skill/@get-convex/convex-migrate/)
Installs badge
Installs badge
[![Installs badge](https://api.skillsafe.ai/v1/badge/@get-convex/convex-migrate/installs)](https://skillsafe.ai/skill/@get-convex/convex-migrate/)
Scan badge
Scan badge
[![Scan badge](https://api.skillsafe.ai/v1/badge/@get-convex/convex-migrate/scan)](https://skillsafe.ai/skill/@get-convex/convex-migrate/)
Eval pass rate badge
Eval pass rate
[![Eval pass rate badge](https://api.skillsafe.ai/v1/badge/@get-convex/convex-migrate/eval)](https://skillsafe.ai/skill/@get-convex/convex-migrate/)