Skip to main content
Want automatic sync? Use the Supabase Integration for one-click OAuth authentication and automatic hourly schema sync.
Supabase is an open-source Firebase alternative that provides a PostgreSQL database with built-in authentication, storage, and real-time subscriptions. This guide covers the manual SQL import method for Supabase databases.
ChartDB never stores or accesses your data - the import query only retrieves schema metadata. The query automatically excludes Supabase system schemas (auth, extensions, pgsodium, realtime, storage, vault) to show only your application tables.

Quick Start

1

Create New Diagram

  1. Go to ChartDB
  2. Click File > New in the editor
  3. Select PostgreSQL from the database options
  4. Choose Supabase as the edition
2

Open Supabase SQL Editor

  1. Log in to your Supabase Dashboard
  2. Select your project
  3. Navigate to SQL Editor in the left sidebar
  4. Click New query
3

Run Import Query

Copy the import query from ChartDB and paste it into the Supabase SQL Editor. Click Run to execute.
4

Copy Results

  1. After the query runs, you’ll see a JSON result
  2. Click on the result cell
  3. Click Copy cell content or use the copy button
5

Import to ChartDB

  1. Go back to ChartDB
  2. Paste the JSON into the import field
  3. Click Import to generate your diagram

Import Query

Run this query in your Supabase SQL Editor:

Connection Details (Alternative Method)

If you prefer to connect using a database client like pgAdmin or DBeaver, you can find your Supabase connection credentials:
1

Navigate to Database Settings

  1. Go to your Supabase Dashboard
  2. Select your project
  3. Click Project Settings (gear icon) in the sidebar
  4. Navigate to Database
2

Find Connection Parameters

Under Connection parameters, you’ll find:
  • Host: db.[project-ref].supabase.co
  • Database name: postgres
  • Port: 5432
  • User: postgres
  • Password: Your database password (set during project creation)
Make sure to use the Direct connection string, not the pooled connection. The direct connection is required for schema introspection queries.
3

Run Query via psql

You can also use the command line to import:

Excluded Schemas

The Supabase import query automatically excludes these internal schemas to keep your diagram focused on your application tables:
If you need to visualize these system schemas, use the standard PostgreSQL import query instead.

Troubleshooting

Common Issues

Solutions for frequently encountered import problems

PostgreSQL Import

Full PostgreSQL documentation including alternative import methods