supabase / supabase

The open source Firebase alternative, built on Postgres.

74.0k

TypeScript

Architecture: monorepo

View Original Source

main

supabase

apps

studio

docs

www

packages

common

config

docker

docker-compose.yml

examples

i18n

package.json

turbo.json

Structural Architecture

Supabase is a Turborepo monorepo that separates deployable applications from shared libraries. Applications such as the studio and documentation site live under apps, while shared UI and configuration live under packages, so a change to the design system propagates to every surface without duplication.

apps and packages split, the conventional Turborepo layout.
Self-hosting configuration versioned alongside the product it deploys.
Examples maintained in-repo so they track API changes.

Notable Directories

/apps

Deployable applications, including the Studio dashboard, documentation site, and marketing pages.

/packages

Shared libraries consumed by the apps, such as the UI component library and shared configuration.

/docker

Compose files and configuration for self-hosting the full stack.

/examples

Reference integrations demonstrating the platform across frameworks.

Build Your Own Ecosystem

Learn from supabase's structure and craft your own software scaffolding.