# cloudoperators/juno architecture

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

- Interactive diagram: https://gitdiagram.com/cloudoperators/juno
- Repository: https://github.com/cloudoperators/juno

## Overview

Juno is a platform of reusable frontend libraries and applications. Its user-facing products cover alert management (Supernova), security and compliance (Heureka), and policy violations (Doop); Greenhouse provides an additional admin interface. Their common runtime pattern is app routing and state feeding domain views and API operations, while shared packages supply UI, authentication, URL state, messaging, and Kubernetes access. The excerpts show selected wiring, not every application workflow; documented but unsampled capabilities are included without speculative call chains.

Main entry points: [`apps/heureka/src/App.tsx`](https://github.com/cloudoperators/juno/blob/main/apps/heureka/src/App.tsx) (Heureka dashboard), [`apps/doop/src/App.tsx`](https://github.com/cloudoperators/juno/blob/main/apps/doop/src/App.tsx) (Doop violations), [`apps/supernova/src/App.tsx`](https://github.com/cloudoperators/juno/blob/main/apps/supernova/src/App.tsx) (Supernova alerts), [`packages/k8s-client/src/client.ts`](https://github.com/cloudoperators/juno/blob/main/packages/k8s-client/src/client.ts) (Kubernetes client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_apps["Applications"]
  node_doop["Doop violations<br/>[App.tsx]"]
  node_doopstore["Doop state<br/>[StoreProvider.tsx]"]
  node_doopurl["Doop URL state<br/>[urlStateUtils.ts]"]
  node_heureka["Heureka dashboard<br/>[App.tsx]"]
  node_heurekaroutes["Heureka routes<br/>[routeTree.gen.ts]"]
  node_heurekadata["Heureka service data<br/>[fetchServices.tsx]"]
  node_supernova["Supernova alerts<br/>[App.tsx]"]
  node_supernovastore["Supernova state<br/>[StoreProvider.tsx]"]
  node_supernovaqueries["Supernova queries<br/>[queryFunctions.ts]"]
  node_supernovahook["Bound query hook<br/>[useBoundQuery.ts]"]
  node_greenhouse["Greenhouse admin<br/>[route.tsx]"]
  node_greenhouselayout["Admin layout<br/>[index.tsx]"]
  node_template["App template<br/>[App.tsx]"]
end

subgraph group_shared["Shared frontend libraries"]
  node_ui["Juno UI system"]
  node_notifications["Notifications"]
  node_urlstate["URL state provider<br/>[index.ts]"]
  node_messages["Messages provider<br/>[Messages.tsx]"]
end

subgraph group_identity["Auth and access"]
  node_oauth["OIDC support<br/>[oidcSession.ts]"]
  node_oauthcode["Authorization code flow<br/>[codeFlow.ts]"]
  node_authprovider["Greenhouse auth<br/>[AuthProvider.tsx]"]
end

subgraph group_utilities["Platform utilities"]
  node_k8s["Kubernetes client<br/>[client.ts]"]
  node_k8srequest["HTTP requests<br/>[request.ts]"]
  node_k8swatch["Resource watches<br/>[watch.ts]"]
  node_communicator["Communicator<br/>[index.ts]"]
end

node_user(("Application users"))

node_user -->|"views violations"| node_doop
node_user -->|"manages compliance"| node_heureka
node_user -->|"manages alerts"| node_supernova
node_doop -->|"provides state"| node_doopstore
node_doop -->|"converts URL state"| node_doopurl
node_doop -->|"uses encoding"| node_urlstate
node_heureka -->|"routes through"| node_heurekaroutes
node_heureka -->|"wraps with auth"| node_authprovider
node_heureka -.->|"provides API context"| node_heurekadata
node_heureka -.->|"authenticates via"| node_oauth
node_supernova -->|"provides state"| node_supernovastore
node_supernova -.->|"queries through"| node_supernovahook
node_supernovahook -->|"dispatches query"| node_supernovaqueries
node_supernovaqueries -.->|"fetches domain data"| node_supernova
node_greenhouse -->|"renders layout"| node_greenhouselayout
node_template -.->|"uses design system"| node_ui
node_oauth -->|"uses code flow"| node_oauthcode
node_k8s -->|"sends requests"| node_k8srequest
node_k8s -->|"creates watches"| node_k8swatch

click node_doop "https://github.com/cloudoperators/juno/blob/main/apps/doop/src/App.tsx"
click node_doopstore "https://github.com/cloudoperators/juno/blob/main/apps/doop/src/components/StoreProvider.tsx"
click node_doopurl "https://github.com/cloudoperators/juno/blob/main/apps/doop/src/lib/urlStateUtils.ts"
click node_heureka "https://github.com/cloudoperators/juno/blob/main/apps/heureka/src/App.tsx"
click node_heurekaroutes "https://github.com/cloudoperators/juno/blob/main/apps/heureka/src/routeTree.gen.ts"
click node_heurekadata "https://github.com/cloudoperators/juno/blob/main/apps/heureka/src/api/fetchServices.tsx"
click node_supernova "https://github.com/cloudoperators/juno/blob/main/apps/supernova/src/App.tsx"
click node_supernovastore "https://github.com/cloudoperators/juno/blob/main/apps/supernova/src/components/StoreProvider.tsx"
click node_supernovaqueries "https://github.com/cloudoperators/juno/blob/main/apps/supernova/src/api/queryFunctions.ts"
click node_supernovahook "https://github.com/cloudoperators/juno/blob/main/apps/supernova/src/hooks/useBoundQuery.ts"
click node_greenhouse "https://github.com/cloudoperators/juno/blob/main/apps/greenhouse/src/routes/admin/route.tsx"
click node_greenhouselayout "https://github.com/cloudoperators/juno/blob/main/apps/greenhouse/src/components/admin/Layout/index.tsx"
click node_template "https://github.com/cloudoperators/juno/blob/main/apps/template/src/App.tsx"
click node_ui "https://github.com/cloudoperators/juno/blob/main/packages/ui-components/src/components/AppShell/AppShell.component.tsx"
click node_notifications "https://github.com/cloudoperators/juno/blob/main/packages/ui-components/src/components/NotificationManager/NotificationManager.component.tsx"
click node_urlstate "https://github.com/cloudoperators/juno/blob/main/packages/url-state-provider/src/index.ts"
click node_messages "https://github.com/cloudoperators/juno/blob/main/packages/messages-provider/src/Messages.tsx"
click node_oauth "https://github.com/cloudoperators/juno/blob/main/packages/oauth/src/oidcSession.ts"
click node_oauthcode "https://github.com/cloudoperators/juno/blob/main/packages/oauth/src/codeFlow.ts"
click node_authprovider "https://github.com/cloudoperators/juno/blob/main/packages/greenhouse-auth-provider/src/plugin/AuthProvider.tsx"
click node_k8s "https://github.com/cloudoperators/juno/blob/main/packages/k8s-client/src/client.ts"
click node_k8srequest "https://github.com/cloudoperators/juno/blob/main/packages/k8s-client/src/request.ts"
click node_k8swatch "https://github.com/cloudoperators/juno/blob/main/packages/k8s-client/src/watch.ts"
click node_communicator "https://github.com/cloudoperators/juno/blob/main/packages/communicator/src/index.ts"

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_doop,node_doopstore,node_doopurl,node_heureka,node_heurekaroutes,node_heurekadata,node_supernova,node_supernovastore,node_supernovaqueries,node_supernovahook,node_greenhouse,node_greenhouselayout,node_template,node_user toneBlue
class node_ui,node_notifications,node_urlstate,node_messages toneAmber
class node_oauth,node_oauthcode,node_authprovider toneMint
class node_k8s,node_k8srequest,node_k8swatch,node_communicator toneRose
```

## Components

### Applications

- [Doop violations](https://github.com/cloudoperators/juno/blob/main/apps/doop/src/App.tsx): `apps/doop/src/App.tsx`
- [Doop state](https://github.com/cloudoperators/juno/blob/main/apps/doop/src/components/StoreProvider.tsx): `apps/doop/src/components/StoreProvider.tsx`
- [Doop URL state](https://github.com/cloudoperators/juno/blob/main/apps/doop/src/lib/urlStateUtils.ts): `apps/doop/src/lib/urlStateUtils.ts`
- [Heureka dashboard](https://github.com/cloudoperators/juno/blob/main/apps/heureka/src/App.tsx): `apps/heureka/src/App.tsx`
- [Heureka routes](https://github.com/cloudoperators/juno/blob/main/apps/heureka/src/routeTree.gen.ts): `apps/heureka/src/routeTree.gen.ts`
- [Heureka service data](https://github.com/cloudoperators/juno/blob/main/apps/heureka/src/api/fetchServices.tsx): `apps/heureka/src/api/fetchServices.tsx`
- [Supernova alerts](https://github.com/cloudoperators/juno/blob/main/apps/supernova/src/App.tsx): `apps/supernova/src/App.tsx`
- [Supernova state](https://github.com/cloudoperators/juno/blob/main/apps/supernova/src/components/StoreProvider.tsx): `apps/supernova/src/components/StoreProvider.tsx`
- [Supernova queries](https://github.com/cloudoperators/juno/blob/main/apps/supernova/src/api/queryFunctions.ts): `apps/supernova/src/api/queryFunctions.ts`
- [Bound query hook](https://github.com/cloudoperators/juno/blob/main/apps/supernova/src/hooks/useBoundQuery.ts): `apps/supernova/src/hooks/useBoundQuery.ts`
- [Greenhouse admin](https://github.com/cloudoperators/juno/blob/main/apps/greenhouse/src/routes/admin/route.tsx): `apps/greenhouse/src/routes/admin/route.tsx`
- [Admin layout](https://github.com/cloudoperators/juno/blob/main/apps/greenhouse/src/components/admin/Layout/index.tsx): `apps/greenhouse/src/components/admin/Layout/index.tsx`
- [App template](https://github.com/cloudoperators/juno/blob/main/apps/template/src/App.tsx): `apps/template/src/App.tsx`

### Shared frontend libraries

- [Juno UI system](https://github.com/cloudoperators/juno/blob/main/packages/ui-components/src/components/AppShell/AppShell.component.tsx): `packages/ui-components/src/components/AppShell/AppShell.component.tsx`
- [Notifications](https://github.com/cloudoperators/juno/blob/main/packages/ui-components/src/components/NotificationManager/NotificationManager.component.tsx): `packages/ui-components/src/components/NotificationManager/NotificationManager.component.tsx`
- [URL state provider](https://github.com/cloudoperators/juno/blob/main/packages/url-state-provider/src/index.ts): `packages/url-state-provider/src/index.ts`
- [Messages provider](https://github.com/cloudoperators/juno/blob/main/packages/messages-provider/src/Messages.tsx): `packages/messages-provider/src/Messages.tsx`

### Auth and access

- [OIDC support](https://github.com/cloudoperators/juno/blob/main/packages/oauth/src/oidcSession.ts): `packages/oauth/src/oidcSession.ts`
- [Authorization code flow](https://github.com/cloudoperators/juno/blob/main/packages/oauth/src/codeFlow.ts): `packages/oauth/src/codeFlow.ts`
- [Greenhouse auth](https://github.com/cloudoperators/juno/blob/main/packages/greenhouse-auth-provider/src/plugin/AuthProvider.tsx): `packages/greenhouse-auth-provider/src/plugin/AuthProvider.tsx`

### Platform utilities

- [Kubernetes client](https://github.com/cloudoperators/juno/blob/main/packages/k8s-client/src/client.ts): `packages/k8s-client/src/client.ts`
- [HTTP requests](https://github.com/cloudoperators/juno/blob/main/packages/k8s-client/src/request.ts): `packages/k8s-client/src/request.ts`
- [Resource watches](https://github.com/cloudoperators/juno/blob/main/packages/k8s-client/src/watch.ts): `packages/k8s-client/src/watch.ts`
- [Communicator](https://github.com/cloudoperators/juno/blob/main/packages/communicator/src/index.ts): `packages/communicator/src/index.ts`

### Other components

- **Application users**

## Connections

- Application users → Doop violations: views violations (evidence: `README.md`)
- Application users → Heureka dashboard: manages compliance (evidence: `README.md`)
- Application users → Supernova alerts: manages alerts (evidence: `README.md`)
- Doop violations → Doop state: provides state (evidence: `apps/doop/src/App.tsx`)
- Doop violations → Doop URL state: converts URL state (evidence: `apps/doop/src/App.tsx`)
- Doop violations → URL state provider: uses encoding (evidence: `apps/doop/src/App.tsx`)
- Heureka dashboard → Heureka routes: routes through (evidence: `apps/heureka/src/App.tsx`)
- Heureka dashboard → Greenhouse auth: wraps with auth (evidence: `apps/heureka/src/App.tsx`)
- Heureka dashboard → Heureka service data: provides API context
- Heureka dashboard → OIDC support: authenticates via
- Supernova alerts → Supernova state: provides state (evidence: `apps/supernova/src/App.tsx`)
- Supernova alerts → Bound query hook: queries through
- Bound query hook → Supernova queries: dispatches query (evidence: `apps/supernova/src/hooks/useBoundQuery.ts`)
- Supernova queries → Supernova alerts: fetches domain data
- Greenhouse admin → Admin layout: renders layout (evidence: `apps/greenhouse/src/routes/admin/route.tsx`)
- App template → Juno UI system: uses design system
- OIDC support → Authorization code flow: uses code flow (evidence: `packages/oauth/src/oidcSession.ts`)
- Kubernetes client → HTTP requests: sends requests (evidence: `packages/k8s-client/src/client.ts`)
- Kubernetes client → Resource watches: creates watches (evidence: `packages/k8s-client/src/client.ts`)
