How ayberkarslan/starbase works
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: index.ts API router · main.tsx Workspace UI · auth.ts Authentication · applications.ts Applications and consent
Components 23
User interfaces
- Workspace UI
apps/web/src/main.tsx - Management UI
apps/web/src/management.tsx - Team directory
apps/web/src/directory.tsx - File sharing
apps/web/src/file-sharing.tsx - Developer docs
apps/web/src/developer-docs.tsx
API capabilities
- API router
apps/api/src/index.ts - Organization
apps/api/src/routes/organization.ts - Members
apps/api/src/routes/members.ts - Administration
apps/api/src/routes/management.ts - Directory
apps/api/src/routes/directory.ts - Applications and consent
apps/api/src/routes/applications.ts - Profile and file sharing
apps/api/src/routes/sharing.ts - Notifications
apps/api/src/routes/notifications.ts - Account activity
apps/api/src/activity.ts
Identity and access
- Authentication
apps/api/src/routes/auth.ts - Identity profile
apps/api/src/routes/identity.ts - Session security
apps/api/src/security.ts - API utilities
apps/api/src/common.ts
Integrations
- Starbase SDK
packages/sdk/src/index.ts - Firebase Auth
- Cloudflare D1
Other components
- Member
- Registered application
Connections 33
- Member → Workspace UI: uses
README.md - Workspace UI → API router: requests
- Workspace UI → Management UI: renders
apps/web/src/main.tsx - Workspace UI → Team directory: renders
apps/web/src/main.tsx - Workspace UI → File sharing: renders
apps/web/src/main.tsx - Workspace UI → Developer docs: renders
apps/web/src/main.tsx - API router → Authentication: registers
apps/api/src/index.ts - API router → Identity profile: registers
apps/api/src/index.ts - API router → Organization: registers
apps/api/src/index.ts - API router → Members: registers
apps/api/src/index.ts - API router → Administration: registers
apps/api/src/index.ts - API router → Directory: registers
apps/api/src/index.ts - API router → Applications and consent: registers
apps/api/src/index.ts - API router → Profile and file sharing: registers
apps/api/src/index.ts - API router → Notifications: registers
apps/api/src/index.ts - API router → Authentication: checks sessions
apps/api/src/index.ts - Authentication → Firebase Auth: authenticates
apps/api/src/routes/auth.ts - Authentication → Cloudflare D1: reads and writes
apps/api/src/routes/auth.ts - Authentication → API utilities: issues tokens
apps/api/src/routes/auth.ts - API utilities → Session security: uses token helpers
apps/api/src/common.ts - API utilities → Cloudflare D1: stores sessions
apps/api/src/common.ts - Administration → Cloudflare D1: manages records
apps/api/src/routes/management.ts - Directory → Cloudflare D1: queries directory
apps/api/src/routes/directory.ts - Applications and consent → Cloudflare D1: stores app access
apps/api/src/routes/applications.ts - Applications and consent → API utilities: checks membership
apps/api/src/routes/applications.ts - Applications and consent → Registered application: authorizes
apps/api/src/routes/applications.ts - Registered application → Starbase SDK: integrates with
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
apps/api/src/routes/auth.ts