Stage:
Public Alpha
Available on self-hosted:
N/A
Supabase Branching allows you to create and test changes in separate, temporary environments without affecting your production setup. This feature works similarly to Git branches, enabling safe experimentation with configurations, database schemas, and new features.
Key features
- Git-based workflow: Integrates with GitHub, creating preview branches for each pull request.
- Isolated environments: Each branch has its own Supabase instance with separate API credentials.
- Automatic migrations: Runs new migrations when changes are pushed to the ./supabase/migrations directory.
- Data seeding: Preview branches can be seeded with sample data using ./supabase/seed.sql.
- CI/CD integration: Supports preview deployments with hosting providers like Vercel.
Benefits:
- Risk-free experimentation: Test changes without affecting the production environment.
- Improved collaboration: Multiple team members can work on different features simultaneously.
- Streamlined reviews: Facilitate thorough checks of database changes before merging.
- Rapid iteration: Quickly prototype and validate database-driven features.
Supabase Branching is valuable for:
- Agile teams working on multiple features concurrently
- Projects with complex database schemas requiring careful management
- Applications undergoing significant refactoring or upgrades
- CI/CD pipelines integrating database changes