# strob3/dnf-updater architecture

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

- Interactive diagram: https://gitdiagram.com/strob3/dnf-updater
- Repository: https://github.com/strob3/dnf-updater

## Overview

DNF Updater is a Noctalia bar plugin for checking and applying selected DNF5 and Flatpak updates. The documented workflow starts at the bar widget, opens the updates panel, and sends check or update operations to the background service, which queries package managers and runs selected upgrades. The panel also supports package selection and download-size estimates. An optional helper and Polkit rule support passwordless background upgrades. Relationships are based on the README; no source excerpts were available.

Main entry points: [`service.luau`](https://github.com/strob3/dnf-updater/blob/main/service.luau) (Update Service), [`widget.luau`](https://github.com/strob3/dnf-updater/blob/main/widget.luau) (Bar Widget), [`panel.luau`](https://github.com/strob3/dnf-updater/blob/main/panel.luau) (Updates Panel), [`scripts/dnf-updater-helper.sh`](https://github.com/strob3/dnf-updater/blob/main/scripts/dnf-updater-helper.sh) (Privileged Helper)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["Noctalia Interface"]
  node_widget["Bar Widget<br/>[widget.luau]"]
  node_panel["Updates Panel<br/>[panel.luau]"]
end

subgraph group_updates["Update Workflow"]
  node_service["Update Service<br/>[service.luau]"]
  node_dnf["DNF5"]
  node_flatpak["Flatpak"]
end

subgraph group_privilege["Privilege Support"]
  node_pkexec["pkexec"]
  node_terminal["User Terminal"]
  node_helper["Privileged Helper"]
  node_polkit["Polkit Rule"]
end

node_user(("User"))

node_user -->|"uses"| node_widget
node_widget -->|"opens"| node_panel
node_panel -->|"requests checks or updates"| node_service
node_service -->|"queries and upgrades"| node_dnf
node_service -->|"queries and upgrades"| node_flatpak
node_service -->|"runs privileged upgrades"| node_pkexec
node_service -->|"launches upgrades in"| node_terminal
node_helper -.->|"paired for background upgrades"| node_polkit

click node_widget "https://github.com/strob3/dnf-updater/blob/main/widget.luau"
click node_panel "https://github.com/strob3/dnf-updater/blob/main/panel.luau"
click node_service "https://github.com/strob3/dnf-updater/blob/main/service.luau"
click node_helper "https://github.com/strob3/dnf-updater/blob/main/scripts/dnf-updater-helper.sh"
click node_polkit "https://github.com/strob3/dnf-updater/blob/main/polkit/50-dnf-updater.rules"

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_widget,node_panel,node_user toneBlue
class node_service,node_dnf,node_flatpak toneAmber
class node_pkexec,node_terminal,node_helper,node_polkit toneMint
```

## Components

### Noctalia Interface

- [Bar Widget](https://github.com/strob3/dnf-updater/blob/main/widget.luau): `widget.luau`
- [Updates Panel](https://github.com/strob3/dnf-updater/blob/main/panel.luau): `panel.luau`

### Update Workflow

- [Update Service](https://github.com/strob3/dnf-updater/blob/main/service.luau): `service.luau`
- **DNF5**
- **Flatpak**

### Privilege Support

- **pkexec**
- **User Terminal**
- [Privileged Helper](https://github.com/strob3/dnf-updater/blob/main/scripts/dnf-updater-helper.sh): `scripts/dnf-updater-helper.sh`
- [Polkit Rule](https://github.com/strob3/dnf-updater/blob/main/polkit/50-dnf-updater.rules): `polkit/50-dnf-updater.rules`

### Other components

- **User**

## Connections

- User → Bar Widget: uses (evidence: `README.md`)
- Bar Widget → Updates Panel: opens (evidence: `README.md`)
- Updates Panel → Update Service: requests checks or updates (evidence: `README.md`)
- Update Service → DNF5: queries and upgrades (evidence: `README.md`)
- Update Service → Flatpak: queries and upgrades (evidence: `README.md`)
- Update Service → pkexec: runs privileged upgrades (evidence: `README.md`)
- Update Service → User Terminal: launches upgrades in (evidence: `README.md`)
- Privileged Helper → Polkit Rule: paired for background upgrades (evidence: `README.md`)
