# refinedev/supabase architecture

> Architecture diagram of the GitHub repository refinedev/supabase, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/refinedev/supabase
- Repository: https://github.com/refinedev/supabase

## Overview

Supabase is a Postgres development platform assembled from database, authentication, API, realtime, storage, functions, and management services. The main user workflow is a developer building an application with client libraries that call platform APIs, while Studio provides a dashboard for managing projects. README documentation supports the service relationships below; sampled source adds evidence for Studio’s database-management/query layer. Most service implementations are external to this repository, so they have no repository source path.

Main entry points: [`apps/studio`](https://github.com/refinedev/supabase/tree/master/apps/studio) (Studio dashboard), [`packages/pg-meta/src/query`](https://github.com/refinedev/supabase/tree/master/packages/pg-meta/src/query) (Postgres management API), [`apps/studio/data/query-client.ts`](https://github.com/refinedev/supabase/blob/master/apps/studio/data/query-client.ts) (Studio query client), [`apps/studio/data/database-queues/database-queue-messages-infinite-query.ts`](https://github.com/refinedev/supabase/blob/master/apps/studio/data/database-queues/database-queue-messages-infinite-query.ts) (Queue message query)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_management["Project management"]
  node_studio["Studio dashboard"]
  node_pgmeta["Postgres management API"]
  node_queryclient["Studio query client<br/>[query-client.ts]"]
  node_queuequery["Queue message query"]
end

subgraph group_data["Database and APIs"]
  node_postgres[("Postgres")]
  node_postgrest["PostgREST REST API"]
  node_graphql["GraphQL API"]
end

subgraph group_identity["Identity and files"]
  node_gotrue["GoTrue auth API"]
  node_storage["Storage API"]
end

subgraph group_runtime["Application runtime"]
  node_realtime["Realtime"]
  node_dbfunctions["Database functions"]
  node_edgefunctions["Edge Functions"]
end

subgraph group_clients["Developer access"]
  node_gateway["Kong gateway"]
  node_clientlibs["Client libraries"]
end

node_developer(("Developer"))
node_application["Application"]

node_developer -->|"manages projects"| node_studio
node_developer -->|"builds"| node_application
node_application -->|"uses"| node_clientlibs
node_clientlibs -.->|"calls APIs"| node_gateway
node_gateway -.->|"routes requests"| node_postgrest
node_gateway -.->|"routes requests"| node_gotrue
node_gateway -.->|"routes requests"| node_storage
node_gateway -.->|"routes requests"| node_edgefunctions
node_postgrest -->|"serves database"| node_postgres
node_graphql -->|"exposes database"| node_postgres
node_gotrue -.->|"uses permissions"| node_postgres
node_storage -->|"uses permissions"| node_postgres
node_realtime -->|"tracks changes"| node_postgres
node_dbfunctions -->|"runs in"| node_postgres
node_studio -.->|"manages database"| node_pgmeta
node_pgmeta -->|"manages"| node_postgres
node_studio -.->|"queries through"| node_queryclient
node_queryclient -.->|"supports queries"| node_queuequery
node_queuequery -->|"reads queue data"| node_postgres

click node_studio "https://github.com/refinedev/supabase/tree/master/apps/studio"
click node_pgmeta "https://github.com/refinedev/supabase/tree/master/packages/pg-meta/src/query"
click node_queryclient "https://github.com/refinedev/supabase/blob/master/apps/studio/data/query-client.ts"
click node_queuequery "https://github.com/refinedev/supabase/blob/master/apps/studio/data/database-queues/database-queue-messages-infinite-query.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_studio,node_pgmeta,node_queryclient,node_queuequery toneBlue
class node_postgres,node_postgrest,node_graphql toneAmber
class node_gotrue,node_storage toneMint
class node_realtime,node_dbfunctions,node_edgefunctions toneRose
class node_gateway,node_clientlibs,node_developer,node_application toneIndigo
```

## Components

### Project management

- [Studio dashboard](https://github.com/refinedev/supabase/tree/master/apps/studio): `apps/studio`
- [Postgres management API](https://github.com/refinedev/supabase/tree/master/packages/pg-meta/src/query): `packages/pg-meta/src/query`
- [Studio query client](https://github.com/refinedev/supabase/blob/master/apps/studio/data/query-client.ts): `apps/studio/data/query-client.ts`
- [Queue message query](https://github.com/refinedev/supabase/blob/master/apps/studio/data/database-queues/database-queue-messages-infinite-query.ts): `apps/studio/data/database-queues/database-queue-messages-infinite-query.ts`

### Database and APIs

- **Postgres**
- **PostgREST REST API**
- **GraphQL API**

### Identity and files

- **GoTrue auth API**
- **Storage API**

### Application runtime

- **Realtime**
- **Database functions**
- **Edge Functions**

### Developer access

- **Kong gateway**
- **Client libraries**

### Other components

- **Developer**
- **Application**

## Connections

- Developer → Studio dashboard: manages projects (evidence: `README.md`)
- Developer → Application: builds (evidence: `README.md`)
- Application → Client libraries: uses (evidence: `README.md`)
- Client libraries → Kong gateway: calls APIs (evidence: `README.md`)
- Kong gateway → PostgREST REST API: routes requests (evidence: `README.md`)
- Kong gateway → GoTrue auth API: routes requests (evidence: `README.md`)
- Kong gateway → Storage API: routes requests (evidence: `README.md`)
- Kong gateway → Edge Functions: routes requests (evidence: `README.md`)
- PostgREST REST API → Postgres: serves database (evidence: `README.md`)
- GraphQL API → Postgres: exposes database (evidence: `README.md`)
- GoTrue auth API → Postgres: uses permissions (evidence: `README.md`)
- Storage API → Postgres: uses permissions (evidence: `README.md`)
- Realtime → Postgres: tracks changes (evidence: `README.md`)
- Database functions → Postgres: runs in (evidence: `README.md`)
- Studio dashboard → Postgres management API: manages database (evidence: `README.md`)
- Postgres management API → Postgres: manages (evidence: `README.md`)
- Studio dashboard → Studio query client: queries through (evidence: `apps/studio/data/query-client.ts`)
- Studio query client → Queue message query: supports queries
- Queue message query → Postgres: reads queue data (evidence: `apps/studio/data/database-queues/database-queue-messages-infinite-query.ts`)
