convex-migrate

Migra el esquema y rellena datos en una app de Convex desplegada usando @convex-dev/migrations.

npx skills add https://github.com/get-convex/agent-skills --skill convex-migrate

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.

Más skills de get-convex

convex-performance-audit
get-convex
Audita el rendimiento de Convex en lecturas, suscripciones, contención de escritura y límites de funciones. Úselo para funciones lentas, hallazgos de insights, conflictos OCC o amplificación de lectura.
developmentdatabasedata-analysis
convex
get-convex
Enruta solicitudes generales de Convex a la habilidad de proyecto correcta. Úsalo cuando el usuario pregunte qué habilidad de Convex usar o asigne una tarea de aplicación de Convex poco especificada.
developmentdatabase
convex-setup-auth
get-convex
Configura la autenticación de Convex, el mapeo de identidad y el control de acceso. Úsalo para inicio de sesión, proveedores de autenticación, tablas de usuarios, funciones protegidas o roles en una aplicación de Convex.
developmentdatabaseapi
convex-quickstart
get-convex
Crea o añade Convex a una aplicación. Se usa para nuevos proyectos de Convex, npm create convex@latest, configuración del frontend, variables de entorno, o la primera ejecución de npx convex dev.
developmentdatabase
convex-migration-helper
get-convex
Planifica migraciones de esquemas y datos de Convex con widen-migrate-narrow y @convex-dev/migrations. Úsalo para cambios de esquema disruptivos, rellenos de datos, remodelación de tablas o implementaciones sin tiempo de inactividad.
developmentdatabase
convex-create-component
get-convex
Construye componentes reutilizables de Convex con tablas aisladas y APIs orientadas a la aplicación. Úselo para nuevos componentes, módulos de backend reutilizables, integraciones o trabajo en límites de componentes.
developmentdatabase
convex-optimize
get-convex
Auditar y optimizar una aplicación Convex existente: seguridad, escala, actualizaciones, observabilidad.
convex-env
get-convex
Configura y conecta las variables de entorno / secretos de despliegue de Convex para la aplicación.