SupaForge
COMPARISON

SupaForge vs. pgAdmin / DBeaver Schema Compare

Full Supabase-aware diffing vs generic Postgres tools.

Note: The SupaForge CLI is currently being prepared for public release. to be notified when it's available.

What pgAdmin and DBeaver Offer

pgAdmin and DBeaver are mature, general-purpose database management tools. Both include a schema comparison feature that can diff tables, columns, indexes, constraints, and other DDL objects between two Postgres databases.

They are excellent for ad-hoc visual inspection of two databases. However:

  • They operate at the raw Postgres level — they have no concept of Supabase-specific objects like RLS policies, auth settings, storage buckets, or Edge Functions.
  • They are GUI-only — there is no CLI to run in a CI/CD pipeline.
  • Their schema diff is often point-in-time and stateless — no history, no scoring, no automated promotion.

What SupaForge Adds

SupaForge treats Supabase as a first-class platform. Beyond schema, it compares every check that GUI tools cannot see:

FeaturepgAdmin / DBeaverSupaForge
Schema diff✅ Visual GUI comparison✅ Full DDL + generated SQL
RLS policies❌ Not Supabase-aware✅ Dedicated RLS check
Auth settings✅ 20+ auth settings
Storage✅ Bucket metadata + policies
Cron jobs✅ pg_cron comparison
Reference dataLimited (manual export)✅ Row-level diff
Edge Functions✅ Version detection
CLI / CI/CD❌ GUI only✅ Single CLI command
Drift score✅ 0–100 score + severity
Promote / applyManual copy-paste SQL✅ One-command promote + dry-run
History / reports✅ Stored per-project reports

Quick Start

Install
npm i -g @akalforge/supaforge
supaforge.config.json
{
  "environments": {
    "staging": {
      "dbUrl": "postgresql://user:pass@db.STAGING_REF.supabase.co:5432/postgres",
      "projectRef": "STAGING_REF",
      "apiKey": "your-staging-service-role-key"
    },
    "production": {
      "dbUrl": "postgresql://user:pass@db.PROD_REF.supabase.co:5432/postgres",
      "projectRef": "PROD_REF",
      "apiKey": "your-production-service-role-key"
    }
  },
  "source": "staging",
  "target": "production"
}
Run a full environment scan
supaforge scan

When pgAdmin / DBeaver Is the Right Choice

For one-off database exploration, writing queries, or visually browsing data, pgAdmin and DBeaver remain excellent tools. If you need to inspect a single table's structure or run an ad-hoc query, a GUI is often faster than the CLI.

Where SupaForge excels is in ongoing, automated drift detection across everything Supabase manages — not just Postgres schema.

Summary

pgAdmin and DBeaver offer visual Postgres schema diffing. SupaForge adds Supabase-aware checks across every Supabase-specific surface, a CLI for CI/CD, drift scoring, and one-command promotion — covering the full surface area that GUI tools miss.

Ready to try SupaForge?

Detect drift across all your Supabase environments in seconds.

View on GitHub