# SupaForge

> Diff and sync your Supabase environments before prod breaks. SupaForge compares schema and data, RLS policies, grants, storage, auth, Edge Functions, cron and more - and fixes the target safely.

SupaForge is an open-source CLI, MCP server and GitHub Action. Install with `npm install -g @akal/supaforge`. Every page below is also available as HTML at the same address without `.md`.

## Overview

- [SupaForge - Diff and Sync Supabase Environments](https://supaforge.dev/index.html.md): Diff and sync your Supabase environments before prod breaks. SupaForge compares schema and data, RLS policies, grants, storage, auth, Edge Functions, cron and more - and fixes the target safely.
- [SupaForge Comparisons & Guides - Learn, Compare, Get Started](https://supaforge.dev/compare.md): Compare SupaForge to other database tools and learn how to detect drift, sync environments, and promote changes safely across Supabase projects.
- [SupaForge How-To Guides - Step-by-Step Supabase Drift Detection](https://supaforge.dev/guides.md): Step-by-step guides for detecting RLS drift, syncing auth settings, auditing storage buckets, and promoting changes safely across Supabase environments.


## Guides

- [How to Audit Storage Buckets for Config Drift](https://supaforge.dev/guides/how-to-audit-storage-buckets-for-config-drift.md): Detect buckets missing between Supabase environments, public/private mismatches, size and MIME-type limits, and storage policies that differ - then sync them.
- [How to Detect Missing RLS Policies Before Production](https://supaforge.dev/guides/how-to-detect-missing-rls-policies-before-production.md): Find missing, changed or extra Row Level Security policies between Supabase environments, and tables with RLS switched off, using SupaForge.
- [How to Diff Against a Local Clone](https://supaforge.dev/guides/how-to-diff-against-a-local-clone.md): A local clone is plain PostgreSQL, so storage, auth, Edge Functions, Vault, Realtime and Supabase roles have nothing to compare there. Learn how to skip them with --skip or checks.exclude, and how to push local changes safely.
- [How to Enable Incremental Backups for Supabase](https://supaforge.dev/guides/how-to-enable-incremental-backups-for-supabase.md): Understand Point-in-Time Recovery, logical backups, and backup strategies for Supabase projects. Compare free-tier daily backups vs Pro PITR.
- [How to Keep Reference Data & Feature Flags in Sync](https://supaforge.dev/guides/how-to-keep-reference-data-and-feature-flags-in-sync.md): Detect and sync seed tables, lookup data and feature flags across Supabase environments, row by row, so staging and production stay in step.
- [How to Safely Promote Database Changes](https://supaforge.dev/guides/how-to-safely-promote-database-changes.md): Detect, review, rehearse and apply: use SupaForge to promote schema, RLS, auth and other changes to a Supabase production environment safely.
- [How to Secure Your SupaForge Credentials](https://supaforge.dev/guides/how-to-secure-your-supaforge-credentials.md): Best practices for handling the database connection strings and Supabase access tokens SupaForge uses: environment variables, CI secrets, least privilege and MFA.
- [How to Set Up Automated Environment Scans](https://supaforge.dev/guides/how-to-set-up-automated-environment-scans.md): Run SupaForge in CI or on a schedule to catch Supabase environment drift before it reaches production, with GitHub annotations, JSON output and meaningful exit codes.
- [How to Sync Supabase Auth Settings Across Environments](https://supaforge.dev/guides/how-to-sync-supabase-auth-settings.md): Compare and sync sign-in providers, MFA, JWT expiry, CAPTCHA, password rules and the rest of the auth configuration between Supabase projects.
- [How to Use diff Command Modes](https://supaforge.dev/guides/how-to-use-diff-command-modes.md): supaforge diff reports drift by default, shows the SQL with --detail, and fixes the target with --apply. Learn each mode, the --dry-run and --prove safety steps, and the sync and hukam aliases.
- [How to Use SupaForge with AI Agents (MCP)](https://supaforge.dev/guides/how-to-use-supaforge-with-ai-agents.md): Add SupaForge to Cursor, VS Code, Claude Desktop or Claude Code as an MCP server, so your AI agent can find drift between Supabase environments and fix it with your approval.
- [How to Use SupaForge with Supabase Branching](https://supaforge.dev/guides/how-to-use-supaforge-with-supabase-branching.md): Compare a Supabase branch with production across schema, RLS, grants, storage, auth and more, and validate branch changes before merging.


## Comparisons

- [SupaForge vs. DBDiff - Supabase-Specific Checks Beyond Schema & Data](https://supaforge.dev/compare/supaforge-vs-dbdiff.md): DBDiff writes schema and data migrations for MySQL, PostgreSQL and SQLite. SupaForge builds on it for Supabase: grants, storage, auth, cron, webhooks, Edge Functions and more, with safe apply.
- [SupaForge vs. Flyway / Liquibase - Supabase-Native Drift Detection](https://supaforge.dev/compare/supaforge-vs-flyway-liquibase.md): Flyway and Liquibase apply the migrations you write. SupaForge finds the changes nobody wrote down across a whole Supabase project - RLS, grants, storage, auth, cron, Edge Functions - and fixes them.
- [SupaForge vs. Manual SQL Diffing - Why Automated Sync Wins](https://supaforge.dev/compare/supaforge-vs-manual-sql-diffing.md): Compare hand-writing SQL to replicate changes with SupaForge's automated Supabase environment diff and apply. Covers schema, RLS, grants, auth, storage, cron and more.
- [SupaForge vs. pgAdmin / DBeaver Schema Compare - Supabase-Aware Diffing](https://supaforge.dev/compare/supaforge-vs-pgadmin-dbeaver-schema-compare.md): pgAdmin and DBeaver offer generic Postgres schema comparison. SupaForge understands Supabase - RLS, grants, storage, auth, cron, Edge Functions and more - and runs anywhere a command does.
- [SupaForge vs. Supabase CLI db diff - Beyond Schema Diffing](https://supaforge.dev/compare/supaforge-vs-supabase-cli-db-diff.md): Supabase CLI's db diff covers the Postgres schema. SupaForge compares two live environments across schema and data, RLS, grants, storage, auth, cron, webhooks, Edge Functions and more - and applies the fixes safely.


## Optional

- [Everything on this site in one file](https://supaforge.dev/llms-full.txt)
- [Source code and README](https://github.com/akalsoftware/supaforge)
- [npm package](https://www.npmjs.com/package/@akal/supaforge)