migratix

Automate zero-downtime Supabase schema migrations with expand/contract workflows.

1|Updated Mar 10, 2026
One-click install
npx skills add https://github.com/dduquenne/unanima-platform --skill migratix
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: migratix
Source: https://github.com/dduquenne/unanima-platform/tree/main/.claude/skills/migratix
Command: npx skills add https://github.com/dduquenne/unanima-platform --skill migratix

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Schema evolution and data migrations for production apps without downtime, ensuring safe, reversible changes.

Core Features & Use Cases

  • Zero-downtime schema changes using expand/contract patterns
  • Reversible migrations with explicit rollback strategies
  • Cross-project coordination for multi-Supabase deployments

Quick Start

Deploy the initial expand migration, adapt TypeScript to handle both schemas, and validate data integrity in staging before the contract.

Frequently Asked Questions about migratix

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

FAQPage Schema
How do I perform zero-downtime database migrations in Supabase?

You can perform zero-downtime database migrations in Supabase by applying expand/contract patterns that separate schema deployment from code changes. This approach coordinates SQL scripts, TypeScript adaptations, and data backfills across multi-project deployments to maintain continuous availability.

What is the expand/contract pattern for database schema evolution?

The expand/contract pattern for database schema evolution separates changes into two phases: expanding the schema to support both old and new versions, then contracting to remove deprecated structures. This ensures zero-downtime migrations by maintaining backward compatibility throughout the transition.

How do I rollback a database migration if a deployment fails?

You can rollback a database migration using explicit reversible steps built into the migration workflow. Each deployment includes a defined rollback strategy that reverses SQL schema changes and restores data integrity, allowing safe reversion if validation fails in staging or production.

Can I coordinate database migrations across multiple Supabase projects?

Yes, you can coordinate database migrations across multiple Supabase projects through cross-project synchronization. The migration workflow manages schema evolution and data changes simultaneously across connected deployments, ensuring deterministic expand/contract workflows and code compatibility for business applications.

Do I need to update TypeScript code when running zero-downtime migrations?

Yes, you need to update TypeScript code when running zero-downtime migrations to handle both old and new database schemas during the transition period. Code compatibility is required throughout the expand phase before the contract phase safely removes the deprecated schema elements.

What are the limitations of zero-downtime migrations for business apps?

Zero-downtime migrations for business apps require strict adherence to expand/contract workflows, meaning certain schema changes cannot be applied in a single step. Complex data transformations need staged backfills, and full rollback capability depends on maintaining backward-compatible TypeScript code throughout the migration window.