OSAC UI is the web console for the Open Sovereign AI Cloud (OSAC) project — a self-service platform for deploying OpenShift clusters, virtual machines, and bare metal hosts. It is a pnpm monorepo consisting of a React 19 + PatternFly 6 single-page application and a Go chi reverse proxy that handles OIDC authentication and forwards requests to the upstream fulfillment-service.
| Path | Purpose |
|---|---|
apps/app-frontend/ |
React SPA (Vite, React 19, TanStack Query, react-router-dom 7) |
libs/api-contracts/ |
Shared TypeScript types and wire normalizers |
libs/types/ |
Generated protobuf types (do not edit) |
libs/ui-components/ |
Shared PatternFly 6 component library |
proxy/ |
Go chi reverse proxy — OIDC auth + API forwarding |
deploy/chart/ |
Helm chart for Kubernetes/OpenShift deployment |
docs/ |
Architecture and deployment documentation |
Prerequisites: Node.js 20+, pnpm 9+, Go 1.23+
pnpm installStart the Go proxy (requires a running fulfillment API) and Vite dev server:
FULFILLMENT_API_URL=https://fulfillment.your-env.example.com pnpm dev| Document | Description |
|---|---|
| OpenShift deployment guide | Step-by-step guide for deploying on OpenShift with Keycloak and fulfillment-service |
| API query architecture | How the API layer is split between ui-components and the app |
| AGENTS.md | Dev environment setup, scripts reference, and coding conventions |