How cuongpv1309/bex works
bex is a self-hostable PaaS control plane: a developer or agent submits a Git-backed service or Blueprint, the control plane represents desired state, and the Kubernetes operator builds and rolls out workloads, routing and TLS. The README also describes data services, operational tooling, team administration, and multiple interfaces. The graph uses documented workflow links; source excerpts are limited, so internal links not explicitly shown are omitted.
Main entry points: server.go REST / GraphQL / MCP · src Dashboard · app_controller.go Kubernetes Operator · main.go Render-compatible CLI
Components 18
Control Plane Interfaces
- Dashboard
dashboard/src - REST / GraphQL / MCP
lego/backend/internal/api/server.go - Render-compatible CLI
lego/cli/main.go - Mobile Client
mobile/src/features/capabilities
Deployment Lifecycle
- Blueprint API
lego/backend/internal/api/server.go - App and Database Resources
lego/types/v1alpha1 - Kubernetes Operator
lego/operator/internal/controller/app_controller.go - Build and Rollout
lego/operator/internal/controller/app_controller.go - Routing and TLS
lego/operator/internal/controller/app_controller.go
Runtime Services
- Workloads
lego/operator/internal/controller/app_controller.go - Managed Postgres and Valkey
lego/types/v1alpha1/database_types.go
Agent Platform
- Agent Sessions
dashboard/src/features/agent-sessions - Agent Image Driver
lego/agent-image/driver/src
Operations and Teams
- Deploys, Logs, Metrics
lego/backend/internal/api/server.go - Teams and Billing
lego/backend/internal/workspaces/pipeline.go
Other components
- Developer
- Coding Agent
- Git Repository
Connections 18
- Developer → Dashboard: manages services
README.md - Developer → Render-compatible CLI: deploys with
README.md - Coding Agent → REST / GraphQL / MCP: deploys via MCP
README.md - Git Repository → Blueprint API: provides source
README.md - Dashboard → REST / GraphQL / MCP: uses control plane
README.md - Render-compatible CLI → REST / GraphQL / MCP: operates control plane
README.md - REST / GraphQL / MCP → Blueprint API: serves Blueprint API
lego/backend/internal/api/server.go - Blueprint API → App and Database Resources: compiles intent
README.md - App and Database Resources → Kubernetes Operator: reconciles resources
README.md - Kubernetes Operator → Build and Rollout: builds and rolls out
README.md - Build and Rollout → Workloads: runs workloads
README.md - Kubernetes Operator → Routing and TLS: configures routing
README.md - Developer → Managed Postgres and Valkey: provisions data
README.md - Dashboard → Deploys, Logs, Metrics: views operations
README.md - Dashboard → Teams and Billing: manages teams
README.md - Coding Agent → Agent Sessions: uses sessions
README.md - Agent Sessions → Agent Image Driver: runs agent turns
- Mobile Client → REST / GraphQL / MCP: uses control plane