How m7mmad-omar/sbarbase works
Sbarbase is a self-hosted control plane and gateway for running isolated Supabase projects and environments on one server. Operators and project users manage organizations, projects, credentials, and environment settings through the console; client requests then pass through placement-aware routing to the appropriate upstream services. The README also describes shared-resource admission, workload notifications, and backup/restore capabilities. The source excerpts show the control/gateway wiring and parts of the local runtime; several operational subsystems are represented from documented capabilities and the file tree, not inspected implementations.
Main entry points: control/handler.ts Management routes · managed.ts Managed routing · application.ts HTTP application · gateway/handler.ts Service gateway
Components 23
Management console
- Console UI
ui/App.tsx - Console API client
ui/api.ts
Control plane
- Project catalog
src/control/catalog.ts - Management identity
src/control/auth.ts - Management routes
src/control/handler.ts - Runtime placement
src/control/placement.ts - Project keys
src/control/keys.ts - Invitations
src/control/invitations.ts - Database access
src/control/database.ts - Usage and logs
src/control/observe.ts
Client gateway
- HTTP application
src/control/application.ts - Managed routing
src/gateway/managed.ts - Service gateway
src/gateway/handler.ts - Concurrency control
src/gateway/concurrency.ts
Local runtime
- Supabase services
- Local runtime manager
lab/durable_runtime.py - Resource admission
lab/resource_policy.py - Component runtime
lab/run.py
Recovery and operations
- Backup and restore
lab/recovery_bundle.py - Storage recovery
lab/recovery-check-storage.py - Workload notifications
lab/notification_producers.py
Other components
- Operator
- Project client
Connections 25
- Operator → Console UI: manages projects
README.md - Project client → HTTP application: sends requests
src/control/application.ts - Console UI → Console API client: uses API
ui/App.tsx - Console API client → Management routes: calls management
- HTTP application → Management routes: routes management
src/control/application.ts - HTTP application → Managed routing: routes client traffic
src/control/application.ts - HTTP application → Service gateway: creates gateway
src/control/application.ts - Management routes → Project catalog: reads and updates
src/control/handler.ts - Management routes → Project keys: dispatches credentials
src/control/handler.ts - Management routes → Invitations: dispatches invitations
src/control/handler.ts - Management routes → Database access: dispatches database access
src/control/handler.ts - Management routes → Usage and logs: dispatches metrics
src/control/handler.ts - Management identity → Project catalog: authenticates management
- Managed routing → Project catalog: reads routing state
src/gateway/managed.ts - Managed routing → Runtime placement: resolves placement
src/gateway/managed.ts - Managed routing → Project keys: loads project keys
src/gateway/managed.ts - Managed routing → Service gateway: dispatches requests
src/gateway/managed.ts - Service gateway → Concurrency control: checks concurrency
src/gateway/handler.ts - Service gateway → Supabase services: forwards service traffic
README.md - Local runtime manager → Resource admission: checks capacity
lab/durable_runtime.py - Component runtime → Supabase services: starts local services
- Operator → Backup and restore: initiates recovery
- Backup and restore → Storage recovery: restores storage
lab/recovery-check-storage.py - Local runtime manager → Workload notifications: produces alerts
- Resource admission → Workload notifications: signals overload