design

Supabase: Dedicated Postgres DB

Name: Supabase: Dedicated Postgres DB
Author: supabase

Get a dedicated Postgres database with Supabase. For founders building web, mobile, and AI apps with 105k+ GitHub stars.

108,368 stars13,641 forksTypeScriptHealth Score 9/10Updated 8/25/2026100% free · open source

What it does

Supabase provides a dedicated Postgres database for building web, mobile, and AI applications

Install / run

npx supabase init

When to use it

•Building a data-driven web application with a robust backend
•Developing a mobile app that requires a scalable database
•Creating an AI-powered application that needs a reliable data storage solution

Quick start

1Create a new Supabase project by running 'npx supabase init' and following the prompts
2Configure your database by editing the 'supabase.config.json' file
3Run 'npx supabase start' to start the Supabase development server
4Use the Supabase API to interact with your database, such as creating a new table with 'const { data, error } = await supabase.from('mytable').insert([{ name: 'John Doe' }])'
5Explore the Supabase dashboard at 'http://localhost:54321' to manage your database and view logs

Ready-to-paste prompt

npx supabase gen types --db-url https://your-supabase-url.supabase.co --db-key your-supabase-key

Heads up: Make sure to set the 'SUPABASE_URL' and 'SUPABASE_KEY' environment variables to authenticate with your Supabase instance

Saves to your device

Topics

alternative

auth

database

deno

embeddings

example

firebase

nextjs

oauth2

pgvector

postgis

postgres

postgresql

postgrest

realtime

supabase

vectors

websockets

How Supabase: Dedicated Postgres DB works

Codeflow

Free to inspect

Supabase: Dedicated Postgres DB is a very large TypeScript project (~1.2M lines across 8127 code files). It is a full software project: use it through its install path rather than reading it end to end. Last commit this month, Apache-2.0 license, has a test suite.

Size

Very large codebase

~1.2M lines · 8127 code files · days to read — use, don't read

Setup

Developer setup

A real software project. Use it via its install path; don't expect to read it all.

Runs on

Node.js · Docker

Needs API keys (.env)

TypeScript 71%MDX 26%JavaScript 1%CSS 1%Shell 1%

Where to start reading

1
README.md
Start here — what it does and how to install it
2
package.json
Dependencies and the commands it exposes
3
supabase/functions/og-images/index.ts
Inside supabase/ — the main logic begins here
4
examples/_internal/README.md
A worked example — copy this to get going

What's in each folder

apps/Sub-packages / plugins13901 files

examples/Examples you can copy1479 files

packages/Sub-packages / plugins873 files

blocks/Folder117 files

e2e/Tests — proof it works108 files

.github/CI / automation (GitHub Actions)62 files

docker/Deployment / infrastructure62 files

supabase/Core code — the actual logic57 files