convex-migrations

Automate Convex database migration lifecycle with progress tracking and batch execution.

Updated Feb 7, 2026
One-click install
npx skills add https://github.com/rieckt/create-loumi-app --skill convex-migrations-rieckt
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: convex-migrations
Source: https://github.com/rieckt/create-loumi-app/tree/main/template/skills/convex/convex-migrations
Command: npx skills add https://github.com/rieckt/create-loumi-app --skill convex-migrations-rieckt

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams manage Convex database schema migrations by tracking, executing, and auditing changes across versions.

Core Features & Use Cases

  • Start, monitor, and resume migrations with a robust progress tracker.
  • Backfill data safely in batches and handle failures gracefully.
  • Use a reusable migration runner to coordinate multi-step migrations with status and error reporting.

Quick Start

Start a new migration flow for your Convex schema and monitor its progress. Example: Start the migration named add_user_timestamps_v1 and periodically check progress until completion.

Frequently Asked Questions about convex-migrations

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

FAQPage Schema
How do I run database schema migrations in Convex safely?

To run database schema migrations in Convex safely, use a reusable migration runner to track progress, execute batch updates, and handle completion or failure with status auditing. You start a migration flow and monitor progress periodically until it finishes.

Can I backfill data in batches with Convex without downtime?

Yes, you can backfill data in batches with Convex by using an automated migration runner that updates progress incrementally. This batch processing approach handles failures gracefully and allows resuming migrations safely without downtime.

What is the best way to track Convex migration progress across versions?

The best way to track Convex migration progress is using a robust progress tracker that audits schema changes across versions. It monitors batch updates, logs status, and reports errors during multi-step migration execution.

Do I need a Convex server to handle multi-step schema migrations?

Yes, you need the Convex server and internal API utilities exposed in your repository to handle multi-step schema migrations. These dependencies manage batch processing, track migration status, and execute schema changes safely.

Why does my Convex migration fail halfway through a data backfill?

A Convex migration may fail halfway through a data backfill due to batch processing errors or schema conflicts. The migration runner handles failures gracefully by logging errors, allowing you to resume the migration from the last tracked progress point.