convex-migration-helper

Plan and execute Convex schema migrations with zero-downtime strategies.

1|1|Updated Jan 17, 2026
One-click install
npx skills add https://github.com/LucaDeLeo/ASTN --skill convex-migration-helper-lucadeleo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: convex-migration-helper
Source: https://github.com/LucaDeLeo/ASTN/tree/main/.agents/skills/convex-migration-helper
Command: npx skills add https://github.com/LucaDeLeo/ASTN --skill convex-migration-helper-lucadeleo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Plans and executes Convex schema migrations safely, guiding teams through adding fields, creating tables, and data transformations without breaking existing data.

Core Features & Use Cases

  • Supports online migrations that run while the app serves requests.
  • Provides best practices for widening, migrating, and narrowing the schema with zero-downtime patterns.
  • Use cases include adding fields, splitting/merging tables, and backfilling data across documents.

Quick Start

Add a new optional field to an existing table and backfill existing documents safely.

Frequently Asked Questions about convex-migration-helper

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

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

Convex schema migrations can run with zero downtime by widening the schema, backfilling data online, and eventually narrowing the schema to maintain data integrity while the app serves requests.

What is the best way to add a new field to an existing Convex table?

The best way to add a field to a Convex table is adding it as optional, backfilling existing documents with default values, and then narrowing the schema if strict validation is required.

Can I backfill data in Convex while the application is still serving requests?

Yes, online data backfills in Convex run while the application serves requests, allowing you to update existing documents safely without interrupting live traffic.

How do I split or merge Convex tables without breaking existing data?

Splitting or merging Convex tables without breaking data requires a workflow of schema widening, online data transformation, and eventual schema narrowing to ensure data integrity.

When do I need to use schema widening for Convex data transformations?

Schema widening is needed when adding fields, creating tables, or transforming data in Convex, allowing the application to handle both old and new document shapes during the migration.

What are the limitations of online Convex migrations for data backfilling?

Online Convex migrations require careful schema widening and eventual narrowing to avoid data integrity issues, meaning you must manage both old and new document shapes during the transition.