# ayberkarslan/starbase architecture

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

- Interactive diagram: https://gitdiagram.com/ayberkarslan/starbase
- Repository: https://github.com/ayberkarslan/starbase

## Overview

STARBASE is a central account, authorization, and team-workspace product. Members authenticate through the web app, then use profile, directory, organization, application, notification, and sharing capabilities served by the API; registered applications can use the SDK for Starbase sessions. The README documents Firebase Auth and Cloudflare Workers/D1, and notes that the legacy board API is disabled. The graph reflects route registration and selected call evidence; unsampled route internals are represented only as documented capabilities.

Main entry points: [`apps/api/src/index.ts`](https://github.com/ayberkarslan/starbase/blob/main/apps/api/src/index.ts) (API router), [`apps/web/src/main.tsx`](https://github.com/ayberkarslan/starbase/blob/main/apps/web/src/main.tsx) (Workspace UI), [`apps/api/src/routes/auth.ts`](https://github.com/ayberkarslan/starbase/blob/main/apps/api/src/routes/auth.ts) (Authentication), [`apps/api/src/routes/applications.ts`](https://github.com/ayberkarslan/starbase/blob/main/apps/api/src/routes/applications.ts) (Applications and consent)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["User interfaces"]
  node_web["Workspace UI<br/>[main.tsx]"]
  node_management_ui["Management UI<br/>[management.tsx]"]
  node_directory_ui["Team directory<br/>[directory.tsx]"]
  node_sharing_ui["File sharing<br/>[file-sharing.tsx]"]
  node_developer_ui["Developer docs<br/>[developer-docs.tsx]"]
end

subgraph group_api["API capabilities"]
  node_api["API router<br/>[index.ts]"]
  node_org_routes["Organization<br/>[organization.ts]"]
  node_member_routes["Members<br/>[members.ts]"]
  node_management_routes["Administration<br/>[management.ts]"]
  node_directory_routes["Directory<br/>[directory.ts]"]
  node_applications["Applications and consent<br/>[applications.ts]"]
  node_sharing["Profile and file sharing<br/>[sharing.ts]"]
  node_notifications["Notifications<br/>[notifications.ts]"]
  node_activity["Account activity<br/>[activity.ts]"]
end

subgraph group_identity["Identity and access"]
  node_auth_routes["Authentication<br/>[auth.ts]"]
  node_identity_routes["Identity profile<br/>[identity.ts]"]
  node_security["Session security<br/>[security.ts]"]
  node_common["API utilities<br/>[common.ts]"]
end

subgraph group_integration["Integrations"]
  node_sdk["Starbase SDK<br/>[index.ts]"]
  node_firebase{{"Firebase Auth"}}
  node_d1[("Cloudflare D1")]
end

node_member(("Member"))
node_registered_app["Registered application"]

node_member -->|"uses"| node_web
node_web -.->|"requests"| node_api
node_web -->|"renders"| node_management_ui
node_web -->|"renders"| node_directory_ui
node_web -->|"renders"| node_sharing_ui
node_web -->|"renders"| node_developer_ui
node_api -->|"registers"| node_auth_routes
node_api -->|"registers"| node_identity_routes
node_api -->|"registers"| node_org_routes
node_api -->|"registers"| node_member_routes
node_api -->|"registers"| node_management_routes
node_api -->|"registers"| node_directory_routes
node_api -->|"registers"| node_applications
node_api -->|"registers"| node_sharing
node_api -->|"registers"| node_notifications
node_api -->|"checks sessions"| node_auth_routes
node_auth_routes -->|"authenticates"| node_firebase
node_auth_routes -->|"reads and writes"| node_d1
node_auth_routes -->|"issues tokens"| node_common
node_common -->|"uses token helpers"| node_security
node_common -->|"stores sessions"| node_d1
node_management_routes -->|"manages records"| node_d1
node_directory_routes -->|"queries directory"| node_d1
node_applications -->|"stores app access"| node_d1
node_applications -->|"checks membership"| node_common
node_applications -->|"authorizes"| node_registered_app
node_registered_app -->|"integrates with"| node_sdk
node_sdk -.->|"requests authorization"| node_applications
node_sharing_ui -.->|"uses API"| node_sharing
node_management_ui -.->|"manages users"| node_management_routes
node_directory_ui -.->|"browses teams"| node_directory_routes
node_notifications -.->|"uses persistent data"| node_d1
node_auth_routes -->|"records auth activity"| node_activity

click node_web "https://github.com/ayberkarslan/starbase/blob/main/apps/web/src/main.tsx"
click node_management_ui "https://github.com/ayberkarslan/starbase/blob/main/apps/web/src/management.tsx"
click node_directory_ui "https://github.com/ayberkarslan/starbase/blob/main/apps/web/src/directory.tsx"
click node_sharing_ui "https://github.com/ayberkarslan/starbase/blob/main/apps/web/src/file-sharing.tsx"
click node_developer_ui "https://github.com/ayberkarslan/starbase/blob/main/apps/web/src/developer-docs.tsx"
click node_api "https://github.com/ayberkarslan/starbase/blob/main/apps/api/src/index.ts"
click node_auth_routes "https://github.com/ayberkarslan/starbase/blob/main/apps/api/src/routes/auth.ts"
click node_identity_routes "https://github.com/ayberkarslan/starbase/blob/main/apps/api/src/routes/identity.ts"
click node_security "https://github.com/ayberkarslan/starbase/blob/main/apps/api/src/security.ts"
click node_common "https://github.com/ayberkarslan/starbase/blob/main/apps/api/src/common.ts"
click node_org_routes "https://github.com/ayberkarslan/starbase/blob/main/apps/api/src/routes/organization.ts"
click node_member_routes "https://github.com/ayberkarslan/starbase/blob/main/apps/api/src/routes/members.ts"
click node_management_routes "https://github.com/ayberkarslan/starbase/blob/main/apps/api/src/routes/management.ts"
click node_directory_routes "https://github.com/ayberkarslan/starbase/blob/main/apps/api/src/routes/directory.ts"
click node_applications "https://github.com/ayberkarslan/starbase/blob/main/apps/api/src/routes/applications.ts"
click node_sharing "https://github.com/ayberkarslan/starbase/blob/main/apps/api/src/routes/sharing.ts"
click node_notifications "https://github.com/ayberkarslan/starbase/blob/main/apps/api/src/routes/notifications.ts"
click node_activity "https://github.com/ayberkarslan/starbase/blob/main/apps/api/src/activity.ts"
click node_sdk "https://github.com/ayberkarslan/starbase/blob/main/packages/sdk/src/index.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_web,node_management_ui,node_directory_ui,node_sharing_ui,node_developer_ui toneBlue
class node_api,node_org_routes,node_member_routes,node_management_routes,node_directory_routes,node_applications,node_sharing,node_notifications,node_activity toneAmber
class node_auth_routes,node_identity_routes,node_security,node_common toneMint
class node_sdk,node_firebase,node_d1 toneRose
class node_member,node_registered_app toneIndigo
```

## Components

### User interfaces

- [Workspace UI](https://github.com/ayberkarslan/starbase/blob/main/apps/web/src/main.tsx): `apps/web/src/main.tsx`
- [Management UI](https://github.com/ayberkarslan/starbase/blob/main/apps/web/src/management.tsx): `apps/web/src/management.tsx`
- [Team directory](https://github.com/ayberkarslan/starbase/blob/main/apps/web/src/directory.tsx): `apps/web/src/directory.tsx`
- [File sharing](https://github.com/ayberkarslan/starbase/blob/main/apps/web/src/file-sharing.tsx): `apps/web/src/file-sharing.tsx`
- [Developer docs](https://github.com/ayberkarslan/starbase/blob/main/apps/web/src/developer-docs.tsx): `apps/web/src/developer-docs.tsx`

### API capabilities

- [API router](https://github.com/ayberkarslan/starbase/blob/main/apps/api/src/index.ts): `apps/api/src/index.ts`
- [Organization](https://github.com/ayberkarslan/starbase/blob/main/apps/api/src/routes/organization.ts): `apps/api/src/routes/organization.ts`
- [Members](https://github.com/ayberkarslan/starbase/blob/main/apps/api/src/routes/members.ts): `apps/api/src/routes/members.ts`
- [Administration](https://github.com/ayberkarslan/starbase/blob/main/apps/api/src/routes/management.ts): `apps/api/src/routes/management.ts`
- [Directory](https://github.com/ayberkarslan/starbase/blob/main/apps/api/src/routes/directory.ts): `apps/api/src/routes/directory.ts`
- [Applications and consent](https://github.com/ayberkarslan/starbase/blob/main/apps/api/src/routes/applications.ts): `apps/api/src/routes/applications.ts`
- [Profile and file sharing](https://github.com/ayberkarslan/starbase/blob/main/apps/api/src/routes/sharing.ts): `apps/api/src/routes/sharing.ts`
- [Notifications](https://github.com/ayberkarslan/starbase/blob/main/apps/api/src/routes/notifications.ts): `apps/api/src/routes/notifications.ts`
- [Account activity](https://github.com/ayberkarslan/starbase/blob/main/apps/api/src/activity.ts): `apps/api/src/activity.ts`

### Identity and access

- [Authentication](https://github.com/ayberkarslan/starbase/blob/main/apps/api/src/routes/auth.ts): `apps/api/src/routes/auth.ts`
- [Identity profile](https://github.com/ayberkarslan/starbase/blob/main/apps/api/src/routes/identity.ts): `apps/api/src/routes/identity.ts`
- [Session security](https://github.com/ayberkarslan/starbase/blob/main/apps/api/src/security.ts): `apps/api/src/security.ts`
- [API utilities](https://github.com/ayberkarslan/starbase/blob/main/apps/api/src/common.ts): `apps/api/src/common.ts`

### Integrations

- [Starbase SDK](https://github.com/ayberkarslan/starbase/blob/main/packages/sdk/src/index.ts): `packages/sdk/src/index.ts`
- **Firebase Auth**
- **Cloudflare D1**

### Other components

- **Member**
- **Registered application**

## Connections

- Member → Workspace UI: uses (evidence: `README.md`)
- Workspace UI → API router: requests
- Workspace UI → Management UI: renders (evidence: `apps/web/src/main.tsx`)
- Workspace UI → Team directory: renders (evidence: `apps/web/src/main.tsx`)
- Workspace UI → File sharing: renders (evidence: `apps/web/src/main.tsx`)
- Workspace UI → Developer docs: renders (evidence: `apps/web/src/main.tsx`)
- API router → Authentication: registers (evidence: `apps/api/src/index.ts`)
- API router → Identity profile: registers (evidence: `apps/api/src/index.ts`)
- API router → Organization: registers (evidence: `apps/api/src/index.ts`)
- API router → Members: registers (evidence: `apps/api/src/index.ts`)
- API router → Administration: registers (evidence: `apps/api/src/index.ts`)
- API router → Directory: registers (evidence: `apps/api/src/index.ts`)
- API router → Applications and consent: registers (evidence: `apps/api/src/index.ts`)
- API router → Profile and file sharing: registers (evidence: `apps/api/src/index.ts`)
- API router → Notifications: registers (evidence: `apps/api/src/index.ts`)
- API router → Authentication: checks sessions (evidence: `apps/api/src/index.ts`)
- Authentication → Firebase Auth: authenticates (evidence: `apps/api/src/routes/auth.ts`)
- Authentication → Cloudflare D1: reads and writes (evidence: `apps/api/src/routes/auth.ts`)
- Authentication → API utilities: issues tokens (evidence: `apps/api/src/routes/auth.ts`)
- API utilities → Session security: uses token helpers (evidence: `apps/api/src/common.ts`)
- API utilities → Cloudflare D1: stores sessions (evidence: `apps/api/src/common.ts`)
- Administration → Cloudflare D1: manages records (evidence: `apps/api/src/routes/management.ts`)
- Directory → Cloudflare D1: queries directory (evidence: `apps/api/src/routes/directory.ts`)
- Applications and consent → Cloudflare D1: stores app access (evidence: `apps/api/src/routes/applications.ts`)
- Applications and consent → API utilities: checks membership (evidence: `apps/api/src/routes/applications.ts`)
- Applications and consent → Registered application: authorizes (evidence: `apps/api/src/routes/applications.ts`)
- Registered application → Starbase SDK: integrates with (evidence: `README.md`)
- Starbase SDK → Applications and consent: requests authorization
- File sharing → Profile and file sharing: uses API
- Management UI → Administration: manages users
- Team directory → Directory: browses teams
- Notifications → Cloudflare D1: uses persistent data
- Authentication → Account activity: records auth activity (evidence: `apps/api/src/routes/auth.ts`)
