# projectbluefin/dakota architecture

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

- Interactive diagram: https://gitdiagram.com/projectbluefin/dakota
- Repository: https://github.com/projectbluefin/dakota

## Overview

Bluefin Dakota is a source-built GNOME OS–based desktop image with stable, testing, and rolling streams. Its principal user workflow is to run the image, report or confirm hardware issues, then verify fixes delivered in a nightly. The graph also shows image composition and delivery, plus gaming and NVIDIA variants. README documents the feedback flow and streams; sampled ownership code supports the metadata-processing layer, but does not establish all build or runtime wiring.

Main entry points: [`elements/oci/bluefin.bst`](https://github.com/projectbluefin/dakota/blob/testing/elements/oci/bluefin.bst) (Bluefin image), [`elements/oci/bluefin-nvidia.bst`](https://github.com/projectbluefin/dakota/blob/testing/elements/oci/bluefin-nvidia.bst) (NVIDIA image), [`README.md`](https://github.com/projectbluefin/dakota/blob/testing/README.md) (Image streams), [`elements/oci/layers`](https://github.com/projectbluefin/dakota/tree/testing/elements/oci/layers) (OCI image layers)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_composition["Image composition"]
  node_gnome["GNOME OS base"]
  node_bluefin["Bluefin components"]
  node_gaming["Gaming components"]
  node_nvidia["NVIDIA components"]
  node_oci_layers["OCI image layers"]
  node_bluefin_image["Bluefin image<br/>[bluefin.bst]"]
  node_nvidia_image["NVIDIA image<br/>[bluefin-nvidia.bst]"]
end

subgraph group_delivery["Image delivery"]
  node_streams["Image streams<br/>[README.md]"]
  node_registry[("Image registry")]
  node_bootc["bootc updates"]
end

subgraph group_feedback["Hardware feedback"]
  node_report["Report system state<br/>[README.md]"]
  node_confirm["Confirm issue<br/>[README.md]"]
  node_verify["Verify nightly fix<br/>[README.md]"]
  node_gist["User-owned gist"]
  node_issue["Upstream issue"]
  node_nightly["Nightly fix"]
end

subgraph group_ownership["Ownership metadata"]
  node_ownership_plugin["Chunkah ownership"]
  node_ownership_metadata["Ownership metadata"]
end

node_user(("Dakota user"))

node_gnome -->|"builds on"| node_bluefin_image
node_bluefin -->|"composes"| node_bluefin_image
node_oci_layers -->|"assembles"| node_bluefin_image
node_gaming -.->|"optional variant"| node_bluefin_image
node_nvidia -->|"composes"| node_nvidia_image
node_oci_layers -->|"assembles"| node_nvidia_image
node_bluefin_image -->|"published as"| node_streams
node_nvidia_image -->|"published as"| node_streams
node_streams -->|"distributed through"| node_registry
node_user -->|"switches or updates"| node_bootc
node_registry -->|"provides image"| node_bootc
node_user -->|"runs"| node_report
node_report -->|"creates"| node_gist
node_user -->|"runs"| node_confirm
node_confirm -->|"adds fingerprint"| node_issue
node_user -->|"runs"| node_verify
node_nightly -->|"delivers fix"| node_verify
node_verify -->|"reports result"| node_issue
node_ownership_plugin -->|"produces basis for"| node_ownership_metadata

click node_bluefin "https://github.com/projectbluefin/dakota/tree/testing/elements/bluefin"
click node_gaming "https://github.com/projectbluefin/dakota/tree/testing/elements/gaming"
click node_nvidia "https://github.com/projectbluefin/dakota/tree/testing/elements/bluefin-nvidia"
click node_oci_layers "https://github.com/projectbluefin/dakota/tree/testing/elements/oci/layers"
click node_bluefin_image "https://github.com/projectbluefin/dakota/blob/testing/elements/oci/bluefin.bst"
click node_nvidia_image "https://github.com/projectbluefin/dakota/blob/testing/elements/oci/bluefin-nvidia.bst"
click node_streams "https://github.com/projectbluefin/dakota/blob/testing/README.md"
click node_report "https://github.com/projectbluefin/dakota/blob/testing/README.md"
click node_confirm "https://github.com/projectbluefin/dakota/blob/testing/README.md"
click node_verify "https://github.com/projectbluefin/dakota/blob/testing/README.md"
click node_ownership_plugin "https://github.com/projectbluefin/dakota/blob/testing/plugins/chunkah-ownership.py"
click node_ownership_metadata "https://github.com/projectbluefin/dakota/blob/testing/scripts/ownership_metadata.py"

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_gnome,node_bluefin,node_gaming,node_nvidia,node_oci_layers,node_bluefin_image,node_nvidia_image,node_user toneBlue
class node_streams,node_registry,node_bootc toneAmber
class node_report,node_confirm,node_verify,node_gist,node_issue,node_nightly toneMint
class node_ownership_plugin,node_ownership_metadata toneRose
```

## Components

### Image composition

- **GNOME OS base**
- [Bluefin components](https://github.com/projectbluefin/dakota/tree/testing/elements/bluefin): `elements/bluefin`
- [Gaming components](https://github.com/projectbluefin/dakota/tree/testing/elements/gaming): `elements/gaming`
- [NVIDIA components](https://github.com/projectbluefin/dakota/tree/testing/elements/bluefin-nvidia): `elements/bluefin-nvidia`
- [OCI image layers](https://github.com/projectbluefin/dakota/tree/testing/elements/oci/layers): `elements/oci/layers`
- [Bluefin image](https://github.com/projectbluefin/dakota/blob/testing/elements/oci/bluefin.bst): `elements/oci/bluefin.bst`
- [NVIDIA image](https://github.com/projectbluefin/dakota/blob/testing/elements/oci/bluefin-nvidia.bst): `elements/oci/bluefin-nvidia.bst`

### Image delivery

- [Image streams](https://github.com/projectbluefin/dakota/blob/testing/README.md): `README.md`
- **Image registry**
- **bootc updates**

### Hardware feedback

- [Report system state](https://github.com/projectbluefin/dakota/blob/testing/README.md): `README.md`
- [Confirm issue](https://github.com/projectbluefin/dakota/blob/testing/README.md): `README.md`
- [Verify nightly fix](https://github.com/projectbluefin/dakota/blob/testing/README.md): `README.md`
- **User-owned gist**
- **Upstream issue**
- **Nightly fix**

### Ownership metadata

- [Chunkah ownership](https://github.com/projectbluefin/dakota/blob/testing/plugins/chunkah-ownership.py): `plugins/chunkah-ownership.py`
- [Ownership metadata](https://github.com/projectbluefin/dakota/blob/testing/scripts/ownership_metadata.py): `scripts/ownership_metadata.py`

### Other components

- **Dakota user**

## Connections

- GNOME OS base → Bluefin image: builds on
- Bluefin components → Bluefin image: composes
- OCI image layers → Bluefin image: assembles
- Gaming components → Bluefin image: optional variant
- NVIDIA components → NVIDIA image: composes
- OCI image layers → NVIDIA image: assembles
- Bluefin image → Image streams: published as
- NVIDIA image → Image streams: published as
- Image streams → Image registry: distributed through
- Dakota user → bootc updates: switches or updates
- Image registry → bootc updates: provides image
- Dakota user → Report system state: runs
- Report system state → User-owned gist: creates
- Dakota user → Confirm issue: runs
- Confirm issue → Upstream issue: adds fingerprint
- Dakota user → Verify nightly fix: runs
- Nightly fix → Verify nightly fix: delivers fix
- Verify nightly fix → Upstream issue: reports result
- Chunkah ownership → Ownership metadata: produces basis for