# kubeflow/dashboard architecture

> Architecture diagram of the GitHub repository kubeflow/dashboard, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-07-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kubeflow/dashboard
- Repository: https://github.com/kubeflow/dashboard

## Overview

1. This repo is a Kubeflow Dashboard bundle: four versioned Kubernetes-deployed components are built and released together, but each has its own runtime boundary, image, manifests, tests, and ownership.

2. The main functional split is between user-facing dashboard services and cluster-side controllers/webhooks. The dashboard services provide the web UI and API endpoints; the controllers and webhook enforce cluster state, authorization, and pod mutation in Kubernetes.

3. `centraldashboard` is the legacy dashboard implementation. It is a Node/TypeScript service with a browser-facing front end under `public/` and server-side logic under `app/`. The backend serves pages/components, exposes dashboard APIs, and gathers metrics; the front end is a component-based UI that renders notebook/pipeline/activity pages, namespace selection, and embedded iframes.

4. `centraldashboard-angular` is a newer Angular-based implementation with the same conceptual split: `frontend/` for the SPA and `backend/` for the API/proxy layer. Its backend includes services for Kubernetes interaction, environment discovery, metrics, and profile-controller integration, while the frontend handles routing, namespace selection, iframe embedding, URL sync, and error handling.

5. `access-management` (`kfam`) is the authorization/admin service for Kubeflow Profiles and access bindings. It exposes an API defined by Swagger and implements profile/binding management logic in Go, backed by Kubernetes resources and Kubeflow API types. This is the component that central dashboard features use when users manage access or workgroups.

6. `profile-controller` is the core Kubernetes operator. It watches Kubeflow Profile CRs and reconciles them into cluster resources such as namespaces, RBAC, role bindings, and supporting webhooks. It includes API versions for `v1` and `v1beta1`, controller plugins for IAM and workload identity, and separate manager/webhook deployment paths.

7. `poddefaults-webhooks` is a mutating admission webhook for PodDefaults. It defines its own CRD and mutates incoming Pods so they inherit configured defaults such as injected containers or settings. This is a cluster admission boundary rather than a dashboard feature.

8. The main data flow is: user browser → dashboard frontend → dashboard backend → Kubernetes APIs and/or component services. The dashboard renders links and embedded views for Kubeflow tools, but actual authorization and namespace scoping are enforced through Profiles, RBAC, and the access-management/profile-controller stack.

9. Another key flow is cluster reconciliation: Profile CRs or access requests are submitted to Kubernetes → profile-controller or access-management processes them → cluster objects are created/updated → dashboard reads the resulting namespaces, permissions, and environment info to shape the UI.

10. Deployment is Kubernetes-native throughout. Each component has Dockerfiles plus Kustomize manifests with overlays for common, Istio, KServe, cert-manager, and different installation modes. The manifests are the primary architecture boundary for runtime wiring, service accounts, RBAC, webhooks, and network policy.

11. Metrics are first-class in the backend/controller services. The code supports Prometheus and Stackdriver-style metrics in different components, so observability is part of the server-side architecture rather than the UI.

12. Testing and delivery are organized as separate pipelines per component: unit tests, integration tests, multi-arch image builds, and OCI publishing via GitHub Actions. The `testing/` directory contains shared install/deploy scripts for kind, Istio, cert-manager, and component bring-up, which reflects the repo’s deployment-oriented, system-level test boundaries.

Main entry points: [`components/access-management`](https://github.com/kubeflow/dashboard/tree/main/components/access-management) (Access Management), [`components/profile-controller`](https://github.com/kubeflow/dashboard/tree/main/components/profile-controller) (Profile Controller), [`components`](https://github.com/kubeflow/dashboard/tree/main/components) (Kustomize manifests), [`releasing`](https://github.com/kubeflow/dashboard/tree/main/releasing) (Release tooling)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_group_dashboard["Dashboard services"]
  node_node_centraldashboard["Central Dashboard<br/>Node/TS service"]
  node_node_cd_server["Server API<br/>Express backend"]
  node_node_cd_ui["Browser UI<br/>Polymer front end"]
  node_node_cd_angular["Angular Dashboard<br/>Angular app"]
  node_node_cda_backend["Angular API<br/>TS backend"]
  node_node_cda_frontend["Angular SPA<br/>Angular frontend"]
end

subgraph group_group_cluster["Cluster control"]
  node_node_kfam["Access Management<br/>Go API service"]
  node_node_kfam_api["Swagger API<br/>REST contract<br/>[swagger.yaml]"]
  node_node_kfam_logic["Kfam core<br/>Go handlers"]
  node_node_profile_controller["Profile Controller<br/>Kubernetes operator"]
  node_node_pc_api["Profile API<br/>CRD types"]
  node_node_pc_runtime["Controller runtime<br/>manager/webhook"]
  node_node_poddefaults["PodDefaults Webhooks<br/>mutating webhook"]
  node_node_pd_api["PodDefault CRD<br/>settings API"]
  node_node_pd_webhook["Mutation logic<br/>Go webhook"]
end

subgraph group_group_delivery["Delivery"]
  node_node_manifests["Kustomize manifests<br/>deploy wiring"]
  node_node_testing["Shared testing<br/>deploy scripts"]
  node_node_releasing["Release tooling<br/>image/publish"]
end

node_node_centraldashboard -->|"backend"| node_node_cd_server
node_node_centraldashboard -->|"ui"| node_node_cd_ui
node_node_cd_ui -->|"api calls"| node_node_cd_server
node_node_cd_server -->|"profiles/auth"| node_node_kfam
node_node_cd_server -->|"k8s data"| node_node_profile_controller
node_node_cd_server -.->|"cluster state"| node_node_poddefaults
node_node_cd_angular -->|"backend"| node_node_cda_backend
node_node_cd_angular -->|"spa"| node_node_cda_frontend
node_node_cda_frontend -->|"proxy/api"| node_node_cda_backend
node_node_cda_backend -->|"profiles/auth"| node_node_kfam
node_node_cda_backend -->|"k8s data"| node_node_profile_controller
node_node_kfam -->|"contract"| node_node_kfam_api
node_node_kfam -->|"implementation"| node_node_kfam_logic
node_node_kfam -->|"profile ops"| node_node_profile_controller
node_node_profile_controller -->|"types"| node_node_pc_api
node_node_profile_controller -->|"reconcile"| node_node_pc_runtime
node_node_profile_controller -.->|"kfam integration"| node_node_kfam
node_node_poddefaults -->|"crd"| node_node_pd_api
node_node_poddefaults -->|"mutate"| node_node_pd_webhook
node_node_manifests -->|"deploy"| node_node_centraldashboard
node_node_manifests -->|"deploy"| node_node_cd_angular
node_node_manifests -->|"deploy"| node_node_kfam
node_node_manifests -->|"deploy"| node_node_profile_controller
node_node_manifests -->|"deploy"| node_node_poddefaults
node_node_testing -->|"integration"| node_node_manifests
node_node_releasing -->|"image refs"| node_node_manifests
node_node_releasing -->|"publish"| node_node_centraldashboard
node_node_releasing -->|"publish"| node_node_cd_angular
node_node_releasing -->|"publish"| node_node_kfam
node_node_releasing -->|"publish"| node_node_profile_controller
node_node_releasing -->|"publish"| node_node_poddefaults

click node_node_centraldashboard "https://github.com/kubeflow/dashboard/tree/main/components/centraldashboard"
click node_node_cd_server "https://github.com/kubeflow/dashboard/tree/main/components/centraldashboard/app"
click node_node_cd_ui "https://github.com/kubeflow/dashboard/tree/main/components/centraldashboard/public"
click node_node_cd_angular "https://github.com/kubeflow/dashboard/tree/main/components/centraldashboard-angular"
click node_node_cda_backend "https://github.com/kubeflow/dashboard/tree/main/components/centraldashboard-angular/backend/app"
click node_node_cda_frontend "https://github.com/kubeflow/dashboard/tree/main/components/centraldashboard-angular/frontend/src/app"
click node_node_kfam "https://github.com/kubeflow/dashboard/tree/main/components/access-management"
click node_node_kfam_api "https://github.com/kubeflow/dashboard/blob/main/components/access-management/api/swagger.yaml"
click node_node_kfam_logic "https://github.com/kubeflow/dashboard/tree/main/components/access-management/kfam"
click node_node_profile_controller "https://github.com/kubeflow/dashboard/tree/main/components/profile-controller"
click node_node_pc_api "https://github.com/kubeflow/dashboard/tree/main/components/profile-controller/api"
click node_node_pc_runtime "https://github.com/kubeflow/dashboard/tree/main/components/profile-controller/controllers"
click node_node_poddefaults "https://github.com/kubeflow/dashboard/tree/main/components/poddefaults-webhooks"
click node_node_pd_api "https://github.com/kubeflow/dashboard/tree/main/components/poddefaults-webhooks/pkg/apis/settings/v1alpha1"
click node_node_pd_webhook "https://github.com/kubeflow/dashboard/tree/main/components/poddefaults-webhooks"
click node_node_manifests "https://github.com/kubeflow/dashboard/tree/main/components"
click node_node_testing "https://github.com/kubeflow/dashboard/tree/main/testing/shared"
click node_node_releasing "https://github.com/kubeflow/dashboard/tree/main/releasing"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_node_centraldashboard,node_node_cd_server,node_node_cd_ui,node_node_cd_angular,node_node_cda_backend,node_node_cda_frontend toneBlue
class node_node_kfam,node_node_kfam_api,node_node_kfam_logic,node_node_profile_controller,node_node_pc_api,node_node_pc_runtime,node_node_poddefaults,node_node_pd_api,node_node_pd_webhook toneAmber
class node_node_manifests,node_node_testing,node_node_releasing toneMint
```

## Components

### Dashboard services

User-facing dashboard runtimes and UI layers

- [Central Dashboard](https://github.com/kubeflow/dashboard/tree/main/components/centraldashboard): Node/TS service · Legacy dashboard bundle with server and browser UI · `components/centraldashboard`
- [Server API](https://github.com/kubeflow/dashboard/tree/main/components/centraldashboard/app): Express backend · Serves pages, dashboard APIs, metrics, and Kubernetes-backed data · `components/centraldashboard/app`
- [Browser UI](https://github.com/kubeflow/dashboard/tree/main/components/centraldashboard/public): Polymer front end · Notebook, pipeline, activity, namespace, and iframe views · `components/centraldashboard/public`
- [Angular Dashboard](https://github.com/kubeflow/dashboard/tree/main/components/centraldashboard-angular): Angular app · Newer dashboard implementation with SPA frontend and backend proxy · `components/centraldashboard-angular`
- [Angular API](https://github.com/kubeflow/dashboard/tree/main/components/centraldashboard-angular/backend/app): TS backend · Kubernetes proxy, environment discovery, metrics, and profile-controller integration · `components/centraldashboard-angular/backend/app`
- [Angular SPA](https://github.com/kubeflow/dashboard/tree/main/components/centraldashboard-angular/frontend/src/app): Angular frontend · Routing, namespace selection, iframe embedding, URL sync, and error handling · `components/centraldashboard-angular/frontend/src/app`

### Cluster control

Authorization, profile reconciliation, and admission control

- [Access Management](https://github.com/kubeflow/dashboard/tree/main/components/access-management): Go API service · Swagger-defined authorization and profile/binding management service · `components/access-management`
- [Swagger API](https://github.com/kubeflow/dashboard/blob/main/components/access-management/api/swagger.yaml): REST contract · Public API definition for profile and binding operations · `components/access-management/api/swagger.yaml`
- [Kfam core](https://github.com/kubeflow/dashboard/tree/main/components/access-management/kfam): Go handlers · Profile and binding routers, models, monitoring, and Kubernetes-backed logic · `components/access-management/kfam`
- [Profile Controller](https://github.com/kubeflow/dashboard/tree/main/components/profile-controller): Kubernetes operator · Reconciles Kubeflow Profiles into namespaces, RBAC, and webhooks · `components/profile-controller`
- [Profile API](https://github.com/kubeflow/dashboard/tree/main/components/profile-controller/api): CRD types · v1 and v1beta1 Profile API definitions and generated deepcopy code · `components/profile-controller/api`
- [Controller runtime](https://github.com/kubeflow/dashboard/tree/main/components/profile-controller/controllers): manager/webhook · Main reconciliation loop plus webhook deployment path and metrics · `components/profile-controller/controllers`
- [PodDefaults Webhooks](https://github.com/kubeflow/dashboard/tree/main/components/poddefaults-webhooks): mutating webhook · Admission webhook that injects PodDefault settings into Pods · `components/poddefaults-webhooks`
- [PodDefault CRD](https://github.com/kubeflow/dashboard/tree/main/components/poddefaults-webhooks/pkg/apis/settings/v1alpha1): settings API · PodDefault custom resource definition and scheme registration · `components/poddefaults-webhooks/pkg/apis/settings/v1alpha1`
- [Mutation logic](https://github.com/kubeflow/dashboard/tree/main/components/poddefaults-webhooks): Go webhook · Pod mutation, validation, and admission serving path · `components/poddefaults-webhooks`

### Delivery

Kubernetes manifests, release automation, and system tests

- [Kustomize manifests](https://github.com/kubeflow/dashboard/tree/main/components): deploy wiring · Base, overlays, service accounts, RBAC, webhooks, and network policy · `components`
- [Shared testing](https://github.com/kubeflow/dashboard/tree/main/testing/shared): deploy scripts · Kind, Istio, cert-manager, and component bring-up scripts · `testing/shared`
- [Release tooling](https://github.com/kubeflow/dashboard/tree/main/releasing): image/publish · Versioning, manifest image updates, and OCI publishing workflows · `releasing`

## Connections

- Central Dashboard → Server API: backend · Legacy dashboard runtime splits into server logic
- Central Dashboard → Browser UI: ui · Legacy dashboard runtime ships a browser-facing front end
- Browser UI → Server API: api calls · UI requests dashboard data and rendered views from the server
- Server API → Access Management: profiles/auth · Server consults access-management for profile and access data
- Server API → Profile Controller: k8s data · Server reads cluster-scoped profile and namespace state
- Server API → PodDefaults Webhooks: cluster state · Server can surface environment and namespace information shaped by admission/webhooks
- Angular Dashboard → Angular API: backend · Angular bundle includes a backend API/proxy layer
- Angular Dashboard → Angular SPA: spa · Angular bundle includes the user-facing single-page app
- Angular SPA → Angular API: proxy/api · Frontend syncs state and fetches dashboard data through the backend
- Angular API → Access Management: profiles/auth · Angular backend integrates with access-management for workgroup/profile flows
- Angular API → Profile Controller: k8s data · Backend discovers namespaces, environment info, and controller-managed state
- Access Management → Swagger API: contract · Service is defined by its Swagger API surface
- Access Management → Kfam core: implementation · Service routes requests into core Go handlers and models
- Access Management → Profile Controller: profile ops · Access changes are coordinated with profile reconciliation
- Profile Controller → Profile API: types · Operator is driven by Profile CRD versions and generated types
- Profile Controller → Controller runtime: reconcile · Controller runtime performs reconciliation and webhook serving
- Profile Controller → Access Management: kfam integration · Manifest wiring exposes the controller to access-management integration
- PodDefaults Webhooks → PodDefault CRD: crd · Webhook defines and registers the PodDefault API
- PodDefaults Webhooks → Mutation logic: mutate · Admission server applies PodDefault mutations to Pods
- Kustomize manifests → Central Dashboard: deploy · Kustomize wires the legacy dashboard runtime into Kubernetes
- Kustomize manifests → Angular Dashboard: deploy · Kustomize wires the Angular dashboard runtime into Kubernetes
- Kustomize manifests → Access Management: deploy · Kustomize wires the access-management service into Kubernetes
- Kustomize manifests → Profile Controller: deploy · Kustomize wires the profile controller manager and webhook
- Kustomize manifests → PodDefaults Webhooks: deploy · Kustomize wires the PodDefaults admission webhook
- Shared testing → Kustomize manifests: integration · Shared scripts install dependencies and bring components up for tests
- Release tooling → Kustomize manifests: image refs · Release tooling updates manifests with published images
- Release tooling → Central Dashboard: publish · Legacy dashboard image is built and published as part of release
- Release tooling → Angular Dashboard: publish · Angular dashboard image is built and published as part of release
- Release tooling → Access Management: publish · Access-management image is built and published as part of release
- Release tooling → Profile Controller: publish · Profile controller image is built and published as part of release
- Release tooling → PodDefaults Webhooks: publish · PodDefaults webhook image is built and published as part of release
