convex-migrations

Plan and execute zero-downtime Convex schema migrations with batch processing.

Updated Jan 24, 2026
One-click install
npx skills add https://github.com/strataga/claude-setup --skill convex-migrations-strataga
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: convex-migrations
Source: https://github.com/strataga/claude-setup/tree/main/skills/convex-migrations
Command: npx skills add https://github.com/strataga/claude-setup --skill convex-migrations-strataga

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Schema migrations are essential to evolve applications, but they can be risky and time-consuming; this skill provides a structured approach to safely transforming Convex schemas, including adding new fields, backfilling data, removing deprecated fields, and implementing index migrations for zero-downtime deployments.

Core Features & Use Cases

  • Backfill data for newly added fields to preserve data integrity across releases.
  • Add, remove, or rename fields with staged transitions and rollback safety.
  • Create and apply indexes as part of migrations to optimize queries and maintain consistency.
  • Use a reusable migration runner pattern to track progress, ensure idempotence, and coordinate batched work across steps.

Quick Start

Plan and execute a migration for a target table in batches, starting with optional fields and progressively backfilling data.

Frequently Asked Questions about convex-migrations

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I perform zero-downtime schema migrations in Convex?

Zero-downtime schema migrations in Convex are executed by planning end-to-end staged transitions, adding optional fields first, progressively backfilling data, and using a migration runner to coordinate batched work safely.

What is the best way to backfill data for a newly added field without downtime?

To backfill data without downtime, you can use a reusable migration runner pattern that processes updates in batches, tracks progress, and ensures idempotence to preserve data integrity across releases.

Can I safely remove or rename fields in my Convex database schema?

Yes, you can safely remove or rename fields by executing staged transitions with rollback safety, ensuring that deprecated fields are only removed after confirming all dependent application logic has been updated.

How do I create and apply indexes during a Convex schema migration?

You can create and apply indexes as part of your Convex schema migration to optimize queries and maintain consistency, coordinating the index creation within your batched migration runner workflow.

Does the Convex migrations approach support rollback safety and progress tracking?

The Convex migration approach supports rollback safety and progress tracking by utilizing a reusable migration runner that ensures idempotence, tracks batched work steps, and integrates with the internal migrations API.

When do I need a migration runner for my database schema changes?

You need a migration runner when evolving user data models, adding or removing fields, backfilling values, or creating indexes, ensuring that batched work is coordinated and progress is tracked for safe deployments.