# jakoolit/fedora-hyprland architecture

> Architecture diagram of the GitHub repository jakoolit/fedora-hyprland, 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/jakoolit/fedora-hyprland
- Repository: https://github.com/jakoolit/fedora-hyprland

## Overview

KooL’s Fedora Hyprland installer guides a user through installing and configuring a Hyprland desktop on Fedora, with optional drivers, themes, shell setup, and dotfiles. The README documents the main entry point and several optional capabilities; source excerpts were not provided, so internal script-to-script calls are not asserted.

Main entry points: [`install.sh`](https://github.com/jakoolit/fedora-hyprland/blob/main/install.sh) (Guided installer), [`auto-install.sh`](https://github.com/jakoolit/fedora-hyprland/blob/main/auto-install.sh) (Auto clone), [`install-scripts/zsh.sh`](https://github.com/jakoolit/fedora-hyprland/blob/main/install-scripts/zsh.sh) (Zsh setup), [`install-scripts/dotfiles-main.sh`](https://github.com/jakoolit/fedora-hyprland/blob/main/install-scripts/dotfiles-main.sh) (Dotfiles setup)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Installation entry"]
  node_installer["Guided installer<br/>[install.sh]"]
  node_auto["Auto clone<br/>[auto-install.sh]"]
  node_preset["Preset selection<br/>[preset.sh]"]
end

subgraph group_desktop["Desktop setup"]
  node_packages["Hyprland packages<br/>[00-hypr-pkgs.sh]"]
  node_hyprland["Hyprland setup<br/>[hyprland.sh]"]
  node_copr["COPR repositories<br/>[copr.sh]"]
  node_nvidia["NVIDIA drivers<br/>[nvidia.sh]"]
  node_login["SDDM login<br/>[sddm.sh]"]
end

subgraph group_customize["Optional customization"]
  node_sddmtheme["SDDM theme<br/>[sddm_theme.sh]"]
  node_gtk["GTK themes<br/>[gtk_themes.sh]"]
  node_zsh["Zsh setup<br/>[zsh.sh]"]
  node_zshassets["Zsh themes"]
  node_dotfiles["Dotfiles setup<br/>[dotfiles-main.sh]"]
  node_assets["Desktop assets"]
end

subgraph group_recovery["Removal"]
  node_uninstall["Guided uninstall<br/>[uninstall.sh]"]
  node_olduninstall["Legacy uninstall<br/>[uninstall-old.sh]"]
end

node_user(("User"))
node_fedora["Fedora system"]
node_dotsrepo["Hyprland-Dots"]

node_user -->|"runs"| node_installer
node_installer -->|"installs on"| node_fedora
node_user -->|"runs"| node_auto
node_auto -->|"clones and runs"| node_installer
node_installer -.->|"offers options"| node_preset
node_installer -.->|"uses scripts"| node_packages
node_installer -.->|"installs"| node_hyprland
node_installer -->|"configurable via"| node_copr
node_installer -->|"offers driver setup"| node_nvidia
node_installer -->|"offers SDDM"| node_login
node_installer -->|"offers theme"| node_sddmtheme
node_installer -->|"offers themes"| node_gtk
node_installer -->|"offers setup"| node_zsh
node_zsh -.->|"selects theme"| node_zshassets
node_installer -->|"offers dotfiles"| node_dotfiles
node_dotfiles -->|"downloads from"| node_dotsrepo
node_installer -.->|"uses configuration"| node_assets
node_user -->|"runs"| node_uninstall
node_user -->|"may run"| node_olduninstall

click node_installer "https://github.com/jakoolit/fedora-hyprland/blob/main/install.sh"
click node_auto "https://github.com/jakoolit/fedora-hyprland/blob/main/auto-install.sh"
click node_preset "https://github.com/jakoolit/fedora-hyprland/blob/main/preset.sh"
click node_packages "https://github.com/jakoolit/fedora-hyprland/blob/main/install-scripts/00-hypr-pkgs.sh"
click node_hyprland "https://github.com/jakoolit/fedora-hyprland/blob/main/install-scripts/hyprland.sh"
click node_copr "https://github.com/jakoolit/fedora-hyprland/blob/main/install-scripts/copr.sh"
click node_nvidia "https://github.com/jakoolit/fedora-hyprland/blob/main/install-scripts/nvidia.sh"
click node_login "https://github.com/jakoolit/fedora-hyprland/blob/main/install-scripts/sddm.sh"
click node_sddmtheme "https://github.com/jakoolit/fedora-hyprland/blob/main/install-scripts/sddm_theme.sh"
click node_gtk "https://github.com/jakoolit/fedora-hyprland/blob/main/install-scripts/gtk_themes.sh"
click node_zsh "https://github.com/jakoolit/fedora-hyprland/blob/main/install-scripts/zsh.sh"
click node_zshassets "https://github.com/jakoolit/fedora-hyprland/tree/main/assets/add_zsh_theme"
click node_dotfiles "https://github.com/jakoolit/fedora-hyprland/blob/main/install-scripts/dotfiles-main.sh"
click node_assets "https://github.com/jakoolit/fedora-hyprland/tree/main/assets"
click node_uninstall "https://github.com/jakoolit/fedora-hyprland/blob/main/uninstall.sh"
click node_olduninstall "https://github.com/jakoolit/fedora-hyprland/blob/main/uninstall-old.sh"

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_installer,node_auto,node_preset,node_user toneBlue
class node_packages,node_hyprland,node_copr,node_nvidia,node_login toneAmber
class node_sddmtheme,node_gtk,node_zsh,node_zshassets,node_dotfiles,node_assets toneMint
class node_uninstall,node_olduninstall toneRose
class node_fedora,node_dotsrepo toneIndigo
```

## Components

### Installation entry

- [Guided installer](https://github.com/jakoolit/fedora-hyprland/blob/main/install.sh): `install.sh`
- [Auto clone](https://github.com/jakoolit/fedora-hyprland/blob/main/auto-install.sh): `auto-install.sh`
- [Preset selection](https://github.com/jakoolit/fedora-hyprland/blob/main/preset.sh): `preset.sh`

### Desktop setup

- [Hyprland packages](https://github.com/jakoolit/fedora-hyprland/blob/main/install-scripts/00-hypr-pkgs.sh): `install-scripts/00-hypr-pkgs.sh`
- [Hyprland setup](https://github.com/jakoolit/fedora-hyprland/blob/main/install-scripts/hyprland.sh): `install-scripts/hyprland.sh`
- [COPR repositories](https://github.com/jakoolit/fedora-hyprland/blob/main/install-scripts/copr.sh): `install-scripts/copr.sh`
- [NVIDIA drivers](https://github.com/jakoolit/fedora-hyprland/blob/main/install-scripts/nvidia.sh): `install-scripts/nvidia.sh`
- [SDDM login](https://github.com/jakoolit/fedora-hyprland/blob/main/install-scripts/sddm.sh): `install-scripts/sddm.sh`

### Optional customization

- [SDDM theme](https://github.com/jakoolit/fedora-hyprland/blob/main/install-scripts/sddm_theme.sh): `install-scripts/sddm_theme.sh`
- [GTK themes](https://github.com/jakoolit/fedora-hyprland/blob/main/install-scripts/gtk_themes.sh): `install-scripts/gtk_themes.sh`
- [Zsh setup](https://github.com/jakoolit/fedora-hyprland/blob/main/install-scripts/zsh.sh): `install-scripts/zsh.sh`
- [Zsh themes](https://github.com/jakoolit/fedora-hyprland/tree/main/assets/add_zsh_theme): `assets/add_zsh_theme`
- [Dotfiles setup](https://github.com/jakoolit/fedora-hyprland/blob/main/install-scripts/dotfiles-main.sh): `install-scripts/dotfiles-main.sh`
- [Desktop assets](https://github.com/jakoolit/fedora-hyprland/tree/main/assets): `assets`

### Removal

- [Guided uninstall](https://github.com/jakoolit/fedora-hyprland/blob/main/uninstall.sh): `uninstall.sh`
- [Legacy uninstall](https://github.com/jakoolit/fedora-hyprland/blob/main/uninstall-old.sh): `uninstall-old.sh`

### Other components

- **User**
- **Fedora system**
- **Hyprland-Dots**

## Connections

- User → Guided installer: runs (evidence: `README.md`)
- Guided installer → Fedora system: installs on (evidence: `README.md`)
- User → Auto clone: runs (evidence: `README.md`)
- Auto clone → Guided installer: clones and runs (evidence: `README.md`)
- Guided installer → Preset selection: offers options
- Guided installer → Hyprland packages: uses scripts
- Guided installer → Hyprland setup: installs
- Guided installer → COPR repositories: configurable via (evidence: `README.md`)
- Guided installer → NVIDIA drivers: offers driver setup (evidence: `README.md`)
- Guided installer → SDDM login: offers SDDM (evidence: `README.md`)
- Guided installer → SDDM theme: offers theme (evidence: `README.md`)
- Guided installer → GTK themes: offers themes (evidence: `README.md`)
- Guided installer → Zsh setup: offers setup (evidence: `README.md`)
- Zsh setup → Zsh themes: selects theme
- Guided installer → Dotfiles setup: offers dotfiles (evidence: `README.md`)
- Dotfiles setup → Hyprland-Dots: downloads from (evidence: `README.md`)
- Guided installer → Desktop assets: uses configuration
- User → Guided uninstall: runs (evidence: `README.md`)
- User → Legacy uninstall: may run (evidence: `README.md`)
