# ramonmsilvabr/fedora-bootc-gnome architecture

> Architecture diagram of the GitHub repository ramonmsilvabr/fedora-bootc-gnome, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ramonmsilvabr/fedora-bootc-gnome
- Repository: https://github.com/ramonmsilvabr/fedora-bootc-gnome

## Overview

Aviso is a personal Fedora bootc desktop-image project, not a general-purpose application. Its main workflow is to build the NVIDIA image from Fedora bootc, then switch a machine to that image; the README also documents a local Image Builder ISO workflow. The repository separates image variants, OS configuration and package selections, Flatpak setup, and ISO configuration. The README documents outcomes and commands, but no source excerpts were available, so links between individual configuration files and runtime behavior are omitted where they cannot be verified.

Main entry points: [`builds/nvidia/Containerfile`](https://github.com/ramonmsilvabr/fedora-bootc-gnome/blob/main/builds/nvidia/Containerfile) (NVIDIA image), [`services/flatpak-repo-config.service`](https://github.com/ramonmsilvabr/fedora-bootc-gnome/blob/main/services/flatpak-repo-config.service) (Flatpak provisioning), [`builds/image-builder/Containerfile`](https://github.com/ramonmsilvabr/fedora-bootc-gnome/blob/main/builds/image-builder/Containerfile) (Image Builder container), [`iso/config.toml`](https://github.com/ramonmsilvabr/fedora-bootc-gnome/blob/main/iso/config.toml) (ISO configuration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_image["Bootc images"]
  node_nvidia_image["NVIDIA image"]
  node_default_image["Default image"]
end

subgraph group_system["System configuration"]
  node_essentials["Essential packages"]
  node_desktop_packages["Desktop packages<br/>[rpms-desktop.list]"]
  node_driver_packages["Driver packages<br/>[rpms-drivers.list]"]
  node_nvidia_packages["NVIDIA packages"]
  node_kernel_args["Kernel arguments"]
  node_custom_args["Custom kernel arguments"]
end

subgraph group_apps["Flatpak setup"]
  node_flatpak_setup["Flatpak provisioning"]
  node_flatpak_script["Flatpak repository setup"]
  node_flatpak_preinstall["Flatpak preinstall"]
  node_preinstall_list["Preinstall selection<br/>[default.preinstall]"]
end

subgraph group_iso["ISO workflow"]
  node_image_builder["Image Builder container"]
  node_iso_config["ISO configuration<br/>[config.toml]"]
end

node_user(("Machine operator"))
node_fedora["Fedora bootc"]

node_user -->|"pulls base"| node_fedora
node_user -->|"builds image"| node_nvidia_image
node_user -->|"switches system"| node_nvidia_image
node_user -->|"builds ISO image"| node_image_builder
node_user -->|"supplies blueprint"| node_iso_config
node_nvidia_image -.->|"provides Flatpak setup"| node_flatpak_setup

click node_nvidia_image "https://github.com/ramonmsilvabr/fedora-bootc-gnome/blob/main/builds/nvidia/Containerfile"
click node_default_image "https://github.com/ramonmsilvabr/fedora-bootc-gnome/blob/main/builds/default/Containerfile"
click node_essentials "https://github.com/ramonmsilvabr/fedora-bootc-gnome/blob/main/packages/rpms-essentials.list"
click node_desktop_packages "https://github.com/ramonmsilvabr/fedora-bootc-gnome/blob/main/packages/rpms-desktop.list"
click node_driver_packages "https://github.com/ramonmsilvabr/fedora-bootc-gnome/blob/main/packages/rpms-drivers.list"
click node_nvidia_packages "https://github.com/ramonmsilvabr/fedora-bootc-gnome/blob/main/packages/rpms-nvidia-support.list"
click node_kernel_args "https://github.com/ramonmsilvabr/fedora-bootc-gnome/blob/main/configs/1-nvidia-kargs.toml"
click node_custom_args "https://github.com/ramonmsilvabr/fedora-bootc-gnome/blob/main/configs/0-custom-kargs.toml"
click node_flatpak_setup "https://github.com/ramonmsilvabr/fedora-bootc-gnome/blob/main/services/flatpak-repo-config.service"
click node_flatpak_script "https://github.com/ramonmsilvabr/fedora-bootc-gnome/blob/main/scripts/flatpak-repo-config.sh"
click node_flatpak_preinstall "https://github.com/ramonmsilvabr/fedora-bootc-gnome/blob/main/services/flatpak-preinstall.service"
click node_preinstall_list "https://github.com/ramonmsilvabr/fedora-bootc-gnome/blob/main/packages/flatpak/default.preinstall"
click node_image_builder "https://github.com/ramonmsilvabr/fedora-bootc-gnome/blob/main/builds/image-builder/Containerfile"
click node_iso_config "https://github.com/ramonmsilvabr/fedora-bootc-gnome/blob/main/iso/config.toml"

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_nvidia_image,node_default_image toneBlue
class node_essentials,node_desktop_packages,node_driver_packages,node_nvidia_packages,node_kernel_args,node_custom_args toneAmber
class node_flatpak_setup,node_flatpak_script,node_flatpak_preinstall,node_preinstall_list toneMint
class node_image_builder,node_iso_config toneRose
class node_user,node_fedora toneIndigo
```

## Components

### Bootc images

- [NVIDIA image](https://github.com/ramonmsilvabr/fedora-bootc-gnome/blob/main/builds/nvidia/Containerfile): `builds/nvidia/Containerfile`
- [Default image](https://github.com/ramonmsilvabr/fedora-bootc-gnome/blob/main/builds/default/Containerfile): `builds/default/Containerfile`

### System configuration

- [Essential packages](https://github.com/ramonmsilvabr/fedora-bootc-gnome/blob/main/packages/rpms-essentials.list): `packages/rpms-essentials.list`
- [Desktop packages](https://github.com/ramonmsilvabr/fedora-bootc-gnome/blob/main/packages/rpms-desktop.list): `packages/rpms-desktop.list`
- [Driver packages](https://github.com/ramonmsilvabr/fedora-bootc-gnome/blob/main/packages/rpms-drivers.list): `packages/rpms-drivers.list`
- [NVIDIA packages](https://github.com/ramonmsilvabr/fedora-bootc-gnome/blob/main/packages/rpms-nvidia-support.list): `packages/rpms-nvidia-support.list`
- [Kernel arguments](https://github.com/ramonmsilvabr/fedora-bootc-gnome/blob/main/configs/1-nvidia-kargs.toml): `configs/1-nvidia-kargs.toml`
- [Custom kernel arguments](https://github.com/ramonmsilvabr/fedora-bootc-gnome/blob/main/configs/0-custom-kargs.toml): `configs/0-custom-kargs.toml`

### Flatpak setup

- [Flatpak provisioning](https://github.com/ramonmsilvabr/fedora-bootc-gnome/blob/main/services/flatpak-repo-config.service): `services/flatpak-repo-config.service`
- [Flatpak repository setup](https://github.com/ramonmsilvabr/fedora-bootc-gnome/blob/main/scripts/flatpak-repo-config.sh): `scripts/flatpak-repo-config.sh`
- [Flatpak preinstall](https://github.com/ramonmsilvabr/fedora-bootc-gnome/blob/main/services/flatpak-preinstall.service): `services/flatpak-preinstall.service`
- [Preinstall selection](https://github.com/ramonmsilvabr/fedora-bootc-gnome/blob/main/packages/flatpak/default.preinstall): `packages/flatpak/default.preinstall`

### ISO workflow

- [Image Builder container](https://github.com/ramonmsilvabr/fedora-bootc-gnome/blob/main/builds/image-builder/Containerfile): `builds/image-builder/Containerfile`
- [ISO configuration](https://github.com/ramonmsilvabr/fedora-bootc-gnome/blob/main/iso/config.toml): `iso/config.toml`

### Other components

- **Machine operator**
- **Fedora bootc**

## Connections

- Machine operator → Fedora bootc: pulls base (evidence: `README.md`)
- Machine operator → NVIDIA image: builds image (evidence: `README.md`)
- Machine operator → NVIDIA image: switches system (evidence: `README.md`)
- Machine operator → Image Builder container: builds ISO image (evidence: `README.md`)
- Machine operator → ISO configuration: supplies blueprint (evidence: `README.md`)
- NVIDIA image → Flatpak provisioning: provides Flatpak setup (evidence: `README.md`)
