How floci-io/floci-ui works
Floci UI is a web console for exploring and managing resources in local AWS-, Azure-, and GCP-compatible runtimes. Users select a cloud and service, inspect live resources, and perform supported operations; the frontend sends requests through the Cloud Proxy API, which resolves a provider-specific adapter and communicates with the runtime. Separate user workflows cover storage objects, database data, and Kubernetes cluster details. The README documents additional service families exposed through the catalog. Some subsystem links rely on documented capabilities because their implementation was not sampled.
Main entry points: cloudProxyClient.ts Proxy client · App.tsx App routes · CloudProxyService.ts Proxy service · CloudAdapterRegistry.ts Adapter registry
Components 21
Web console
- App routes
packages/frontend/src/App.tsx - Console home
packages/frontend/src/pages/CloudConsoleHomePage.tsx - Cloud Explorer
packages/frontend/src/pages/CloudExplorerPage.tsx - Storage browser
packages/frontend/src/components/StorageObjectBrowser.tsx - Database workspace
packages/frontend/src/pages/DatabaseDataPage.tsx - Kubernetes details
packages/frontend/src/features/k8s/K8sEngineDetails.tsx - Logs query
packages/frontend/src/components/LogsQueryPanel.tsx - Proxy client
packages/frontend/src/api/cloudProxyClient.ts - Other service panels
packages/frontend/src/components
Cloud API
- Cloud routes
packages/api/src/routes/clouds.ts - Proxy service
packages/api/src/service/CloudProxyService.ts - Adapter registry
packages/api/src/registry/CloudAdapterRegistry.ts
Cloud service model
- Service catalog
packages/api/src/cloud-spi/serviceCatalog.ts - Service schemas
packages/api/src/cloud-spi
Provider adapters
- AWS adapters
packages/api/src/adapter-aws - Azure adapters
packages/api/src/adapter-azure - GCP adapters
packages/api/src/adapter-gcp
Other components
- Console user
- AWS-compatible runtime
- Azure-compatible runtime
- GCP-compatible runtime
Connections 24
- Console user → App routes: uses
- App routes → Console home: routes to
- App routes → Cloud Explorer: routes to
- App routes → Database workspace: routes to
- Console home → Proxy client: requests data
- Cloud Explorer → Proxy client: requests resources
- Storage browser → Proxy client: manages objects
- Database workspace → Proxy client: reads resource
- Kubernetes details → Proxy client: manages cluster
- Logs query → Proxy client: queries logs
- Proxy client → Cloud routes: sends requests
- Cloud routes → Proxy service: dispatches
- Proxy service → Adapter registry: resolves adapter
- Proxy service → Service catalog: reads service metadata
- Proxy service → Service schemas: returns schemas
- AWS adapters → Service schemas: uses schemas
- Azure adapters → Service schemas: uses schemas
- GCP adapters → Service schemas: uses schemas
- Adapter registry → AWS adapters: dispatches
- Adapter registry → Azure adapters: dispatches
- Adapter registry → GCP adapters: dispatches
- AWS adapters → AWS-compatible runtime: calls runtime
- Azure adapters → Azure-compatible runtime: calls runtime
- GCP adapters → GCP-compatible runtime: calls runtime