supabase/supabase
Glossary
Terms used across the Supabase repo. Where a term refers to a separately-hosted upstream service, the canonical home is linked.
| Term | Meaning |
|---|---|
| Studio | The dashboard app. Source: apps/studio. Shipped as supabase/studio Docker image and as supabase.com/dashboard. |
| Self-host | Running Supabase on your own infrastructure via the docker/docker-compose.yml bundle. |
| Hosted platform | The managed supabase.com cloud. Source: not in this repo, but Studio's "platform" build target talks to it. |
| Project | A single Supabase deployment — a Postgres database with the surrounding services. The unit Studio operates on. |
| Organization | A billing / membership container that owns one or more projects. |
| Branch | A short-lived database branch on the hosted platform; managed under apps/studio/components/interfaces/BranchManagement. |
| PostgREST | Auto-generated REST API for Postgres. Upstream: postgrest/postgrest. Exposes the database as /rest/v1. |
| GoTrue / Auth | JWT auth API. Upstream: supabase/auth. Exposed under /auth/v1. |
| Realtime | Elixir server for Postgres replication-driven WebSocket fanout. Upstream: supabase/realtime. |
| Storage | RESTful S3-backed file API with Postgres-managed permissions. Upstream: supabase/storage. |
| Edge Functions | User-defined Deno functions running on Edge Runtime. Upstream: supabase/edge-runtime. |
| postgres-meta / pg-meta | Two distinct things: (a) the upstream supabase/postgres-meta HTTP service, and (b) the workspace package packages/pg-meta that generates SQL strings used by Studio. |
| Supavisor | Postgres connection pooler. Upstream: supabase/supavisor. Replaces PgBouncer in newer self-host bundles. |
| Logflare / Vector | The logging stack. Vector ships logs into Logflare which Studio queries for the Logs explorer. |
| Kong | Cloud-native API gateway sitting in front of every per-project service in self-host. |
pg-meta (package) |
packages/pg-meta — a pure-TS library of SQL statement generators for tables, columns, policies, etc. Has no network code. |
ai-commands |
packages/ai-commands — server-side LLM commands. Edge subpath (ai-commands/edge) for streaming usage. |
| Federated docs | Docs content sourced at build time from external repos (e.g. supabase/vecs) and rendered inside apps/docs. |
| DocSpec / SDKSpec / ConfigSpec / CLISpec | Custom Supabase doc-generation specs used by apps/docs/spec/. They drive auto-generated reference pages. |
| Ratchet | apps/studio/scripts/ratchet-eslint-rules.ts — a script that asserts the count of certain ESLint warnings only ever decreases. |
/go/* |
Campaign-page system in apps/www. Pages are typed TS objects, not MDX. See apps/www/_go/. |
| Block | A composed UI fragment (e.g. dashboard, sign-in form). Lives in blocks/ and is published via the ui-library registry. |
| Pattern | A higher-level UI primitive (e.g. command-menu, multi-select) in packages/ui-patterns built on top of packages/ui. |
| Catalog dependencies | pnpm "catalog" entries in pnpm-workspace.yaml — workspace-wide pinned versions for react, next, @supabase/*, etc. |
| MCP | Model Context Protocol. Studio bundles @modelcontextprotocol/sdk and @supabase/mcp-server-supabase so the Assistant can call tools. |
| Brain trust evals | Studio's AI eval harness (apps/studio/evals/). Run via pnpm --filter studio evals:run. |
| First referrer cookie | Marketing attribution cookie persisted by packages/common/first-referrer-cookie.ts. |
| ConfigCat | Feature-flag service used through packages/common/configcat.ts. |
| PostHog | Product analytics; client wrapper at packages/common/posthog-client.ts. |
Built by Factory AutoWiki from public repository content. It is a generated preview for codebase exploration, not source-maintained documentation.