Convex Migration Helper

Plan and implement safe Convex schema and data migrations, especially when changing existing fields, relationships, or required data.

majiayu000 a0a40f8 2 files · 1.9 KB Updated 567 repo stars

File contents

Convex Migration Helper

Use this when a schema change affects existing rows or when data shape must be transformed.

Migration defaults

  • Prefer additive changes first.
  • Add required fields as optional, backfill, then tighten.
  • Use internal functions for migration work.
  • Keep the app running during the migration whenever possible.

When this skill is needed

  • Required fields are being introduced.
  • Field types are changing.
  • Nested data is being split into relational tables.
  • Existing indexes or lookup paths are changing in ways that require backfills.

What to check

  • Is a dual-read or dual-write period needed?
  • Can the migration run in batches?
  • Does the schema need a temporary compatibility state?
  • Are there existing functions that assume the old shape?

majiayu000/claude-skill-registry-data/tree/main/development/convex-migration-helper commit a0a40f8281

Frequently asked questions

npx skillmds add majiayu000/convex-migration-helper