# kubernetes-retired/dashboard architecture

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

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

## Overview

Kubernetes Dashboard is a web UI for managing and troubleshooting Kubernetes workloads and cluster resources. Users enter through the authenticated browser chrome, navigate resource views or tools, and inspect or act on cluster objects; custom-resource views also expose raw YAML/JSON. The repository separates the UI, Kubernetes API, authentication, and metrics scraper into modules. The README documents Kong as the gateway connecting these containers. Source evidence is strongest for UI routing and CRD detail behavior; backend links and several feature implementations are inferred only at subsystem level.

Main entry points: [`modules/web/src/chrome/component.ts`](https://github.com/kubernetes-retired/dashboard/blob/master/modules/web/src/chrome/component.ts) (Authenticated chrome), [`modules/api/pkg/handler/apihandler.go`](https://github.com/kubernetes-retired/dashboard/blob/master/modules/api/pkg/handler/apihandler.go) (Kubernetes API), [`modules/metrics-scraper/main.go`](https://github.com/kubernetes-retired/dashboard/blob/master/modules/metrics-scraper/main.go) (Metrics scraper), [`modules/web/src/crd/crdobject/component.ts`](https://github.com/kubernetes-retired/dashboard/blob/master/modules/web/src/crd/crdobject/component.ts) (Custom resources)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Dashboard UI"]
  node_chrome["Authenticated chrome<br/>[component.ts]"]
  node_workloads["Workloads"]
  node_cluster["Cluster resources"]
  node_discovery["Discovery resources"]
  node_config["Config and storage"]
  node_overview["Cluster overview<br/>[component.ts]"]
  node_crd["Custom resources<br/>[component.ts]"]
  node_create["Resource creation<br/>[component.ts]"]
  node_logs["Workload logs<br/>[component.ts]"]
  node_shell["Container shell<br/>[component.ts]"]
  node_search["Resource search<br/>[component.ts]"]
end

subgraph group_api["Cluster API"]
  node_api["Kubernetes API<br/>[apihandler.go]"]
  node_resource["Resource operations"]
  node_integrations["API integrations<br/>[manager.go]"]
end

subgraph group_support["Identity and Metrics"]
  node_auth["Authentication service<br/>[main.go]"]
  node_metrics["Metrics scraper<br/>[main.go]"]
  node_metricsdb[("Metrics database<br/>[database.go]")]
end

subgraph group_infra["Container Gateway"]
  node_kong["Kong gateway"]
end

node_user(("Dashboard user"))

node_user -->|"uses"| node_chrome
node_chrome -->|"routes to"| node_workloads
node_chrome -->|"routes to"| node_cluster
node_chrome -->|"routes to"| node_discovery
node_chrome -->|"routes to"| node_config
node_chrome -->|"routes to"| node_overview
node_chrome -->|"routes to"| node_crd
node_chrome -->|"routes to"| node_create
node_chrome -->|"routes to"| node_logs
node_chrome -->|"routes to"| node_shell
node_chrome -->|"routes to"| node_search
node_crd -.->|"requests objects"| node_api
node_chrome -.->|"uses API"| node_api
node_api -.->|"handles resources"| node_resource
node_api -.->|"loads integrations"| node_integrations
node_auth -->|"served behind"| node_kong
node_api -->|"served behind"| node_kong
node_metrics -->|"served behind"| node_kong
node_metrics -.->|"stores metrics"| node_metricsdb

click node_chrome "https://github.com/kubernetes-retired/dashboard/blob/master/modules/web/src/chrome/component.ts"
click node_workloads "https://github.com/kubernetes-retired/dashboard/tree/master/modules/web/src/resource/workloads"
click node_cluster "https://github.com/kubernetes-retired/dashboard/tree/master/modules/web/src/resource/cluster"
click node_discovery "https://github.com/kubernetes-retired/dashboard/tree/master/modules/web/src/resource/discovery"
click node_config "https://github.com/kubernetes-retired/dashboard/tree/master/modules/web/src/resource/config"
click node_overview "https://github.com/kubernetes-retired/dashboard/blob/master/modules/web/src/overview/component.ts"
click node_crd "https://github.com/kubernetes-retired/dashboard/blob/master/modules/web/src/crd/crdobject/component.ts"
click node_create "https://github.com/kubernetes-retired/dashboard/blob/master/modules/web/src/create/component.ts"
click node_logs "https://github.com/kubernetes-retired/dashboard/blob/master/modules/web/src/logs/component.ts"
click node_shell "https://github.com/kubernetes-retired/dashboard/blob/master/modules/web/src/shell/component.ts"
click node_search "https://github.com/kubernetes-retired/dashboard/blob/master/modules/web/src/search/component.ts"
click node_api "https://github.com/kubernetes-retired/dashboard/blob/master/modules/api/pkg/handler/apihandler.go"
click node_resource "https://github.com/kubernetes-retired/dashboard/tree/master/modules/api/pkg/resource"
click node_integrations "https://github.com/kubernetes-retired/dashboard/blob/master/modules/api/pkg/integration/manager.go"
click node_auth "https://github.com/kubernetes-retired/dashboard/blob/master/modules/auth/main.go"
click node_metrics "https://github.com/kubernetes-retired/dashboard/blob/master/modules/metrics-scraper/main.go"
click node_metricsdb "https://github.com/kubernetes-retired/dashboard/blob/master/modules/metrics-scraper/pkg/database/database.go"

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_chrome,node_workloads,node_cluster,node_discovery,node_config,node_overview,node_crd,node_create,node_logs,node_shell,node_search,node_user toneBlue
class node_api,node_resource,node_integrations toneAmber
class node_auth,node_metrics,node_metricsdb toneMint
class node_kong toneRose
```

## Components

### Dashboard UI

- [Authenticated chrome](https://github.com/kubernetes-retired/dashboard/blob/master/modules/web/src/chrome/component.ts): `modules/web/src/chrome/component.ts`
- [Workloads](https://github.com/kubernetes-retired/dashboard/tree/master/modules/web/src/resource/workloads): `modules/web/src/resource/workloads`
- [Cluster resources](https://github.com/kubernetes-retired/dashboard/tree/master/modules/web/src/resource/cluster): `modules/web/src/resource/cluster`
- [Discovery resources](https://github.com/kubernetes-retired/dashboard/tree/master/modules/web/src/resource/discovery): `modules/web/src/resource/discovery`
- [Config and storage](https://github.com/kubernetes-retired/dashboard/tree/master/modules/web/src/resource/config): `modules/web/src/resource/config`
- [Cluster overview](https://github.com/kubernetes-retired/dashboard/blob/master/modules/web/src/overview/component.ts): `modules/web/src/overview/component.ts`
- [Custom resources](https://github.com/kubernetes-retired/dashboard/blob/master/modules/web/src/crd/crdobject/component.ts): `modules/web/src/crd/crdobject/component.ts`
- [Resource creation](https://github.com/kubernetes-retired/dashboard/blob/master/modules/web/src/create/component.ts): `modules/web/src/create/component.ts`
- [Workload logs](https://github.com/kubernetes-retired/dashboard/blob/master/modules/web/src/logs/component.ts): `modules/web/src/logs/component.ts`
- [Container shell](https://github.com/kubernetes-retired/dashboard/blob/master/modules/web/src/shell/component.ts): `modules/web/src/shell/component.ts`
- [Resource search](https://github.com/kubernetes-retired/dashboard/blob/master/modules/web/src/search/component.ts): `modules/web/src/search/component.ts`

### Cluster API

- [Kubernetes API](https://github.com/kubernetes-retired/dashboard/blob/master/modules/api/pkg/handler/apihandler.go): `modules/api/pkg/handler/apihandler.go`
- [Resource operations](https://github.com/kubernetes-retired/dashboard/tree/master/modules/api/pkg/resource): `modules/api/pkg/resource`
- [API integrations](https://github.com/kubernetes-retired/dashboard/blob/master/modules/api/pkg/integration/manager.go): `modules/api/pkg/integration/manager.go`

### Identity and Metrics

- [Authentication service](https://github.com/kubernetes-retired/dashboard/blob/master/modules/auth/main.go): `modules/auth/main.go`
- [Metrics scraper](https://github.com/kubernetes-retired/dashboard/blob/master/modules/metrics-scraper/main.go): `modules/metrics-scraper/main.go`
- [Metrics database](https://github.com/kubernetes-retired/dashboard/blob/master/modules/metrics-scraper/pkg/database/database.go): `modules/metrics-scraper/pkg/database/database.go`

### Container Gateway

- **Kong gateway**

### Other components

- **Dashboard user**

## Connections

- Dashboard user → Authenticated chrome: uses
- Authenticated chrome → Workloads: routes to
- Authenticated chrome → Cluster resources: routes to
- Authenticated chrome → Discovery resources: routes to
- Authenticated chrome → Config and storage: routes to
- Authenticated chrome → Cluster overview: routes to
- Authenticated chrome → Custom resources: routes to
- Authenticated chrome → Resource creation: routes to
- Authenticated chrome → Workload logs: routes to
- Authenticated chrome → Container shell: routes to
- Authenticated chrome → Resource search: routes to
- Custom resources → Kubernetes API: requests objects
- Authenticated chrome → Kubernetes API: uses API
- Kubernetes API → Resource operations: handles resources
- Kubernetes API → API integrations: loads integrations
- Authentication service → Kong gateway: served behind
- Kubernetes API → Kong gateway: served behind
- Metrics scraper → Kong gateway: served behind
- Metrics scraper → Metrics database: stores metrics
