# end-4/dots-hyprland architecture

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

- Interactive diagram: https://gitdiagram.com/end-4/dots-hyprland
- Repository: https://github.com/end-4/dots-hyprland

## Overview

This repository is primarily a Hyprland desktop configuration whose custom graphical shell is built with Quickshell. The user-facing workflow is installing the configuration, then using the configured desktop and shell for window management, widgets, overview, AI, and quality-of-life features; wallpaper-based Material theming is another documented capability. The README supports the product-level relationships shown here, but no runtime source excerpts were provided, so internal calls and detailed feature wiring are not asserted.

Main entry points: [`dots/.config/quickshell/ii`](https://github.com/end-4/dots-hyprland/tree/main/dots/.config/quickshell/ii) (Quickshell shell), [`setup`](https://github.com/end-4/dots-hyprland/blob/main/setup) (Setup command), [`dots/.config/hypr`](https://github.com/end-4/dots-hyprland/tree/main/dots/.config/hypr) (Hyprland configuration), [`dots/.config/quickshell/ii/modules/ii`](https://github.com/end-4/dots-hyprland/tree/main/dots/.config/quickshell/ii/modules/ii) (Window overview)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_install["Installation"]
  node_installer["Setup command"]
end

subgraph group_desktop["Desktop configuration"]
  node_hyprland["Hyprland configuration<br/>[hypr]"]
end

subgraph group_shell["Graphical shell"]
  node_quickshell["Quickshell shell<br/>[ii]"]
end

subgraph group_features["Shell capabilities"]
  node_overview["Window overview<br/>[ii]"]
  node_ai["AI features<br/>[ii]"]
  node_qol["QoL features<br/>[modules]"]
  node_theme["Material themes<br/>[templates]"]
  node_widgets["Shell widgets<br/>[ii]"]
end

node_user(("Desktop user"))
node_wallpaper["Wallpaper choice"]

node_user -->|"runs install"| node_installer
node_user -->|"uses desktop"| node_hyprland
node_user -->|"uses shell"| node_quickshell
node_user -->|"views apps"| node_overview
node_user -->|"uses AI"| node_ai
node_user -->|"uses features"| node_qol
node_wallpaper -->|"chooses palette"| node_theme
node_quickshell -->|"provides widgets"| node_widgets

click node_installer "https://github.com/end-4/dots-hyprland/blob/main/setup"
click node_hyprland "https://github.com/end-4/dots-hyprland/tree/main/dots/.config/hypr"
click node_quickshell "https://github.com/end-4/dots-hyprland/tree/main/dots/.config/quickshell/ii"
click node_overview "https://github.com/end-4/dots-hyprland/tree/main/dots/.config/quickshell/ii/modules/ii"
click node_ai "https://github.com/end-4/dots-hyprland/tree/main/dots/.config/quickshell/ii"
click node_qol "https://github.com/end-4/dots-hyprland/tree/main/dots/.config/quickshell/ii/modules"
click node_theme "https://github.com/end-4/dots-hyprland/tree/main/dots/.config/matugen/templates"
click node_widgets "https://github.com/end-4/dots-hyprland/tree/main/dots/.config/quickshell/ii/modules/ii"

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_user toneBlue
class node_hyprland toneAmber
class node_quickshell toneMint
class node_overview,node_ai,node_qol,node_theme,node_widgets toneRose
class node_wallpaper toneIndigo
```

## Components

### Installation

- [Setup command](https://github.com/end-4/dots-hyprland/blob/main/setup): `setup`

### Desktop configuration

- [Hyprland configuration](https://github.com/end-4/dots-hyprland/tree/main/dots/.config/hypr): `dots/.config/hypr`

### Graphical shell

- [Quickshell shell](https://github.com/end-4/dots-hyprland/tree/main/dots/.config/quickshell/ii): `dots/.config/quickshell/ii`

### Shell capabilities

- [Window overview](https://github.com/end-4/dots-hyprland/tree/main/dots/.config/quickshell/ii/modules/ii): `dots/.config/quickshell/ii/modules/ii`
- [AI features](https://github.com/end-4/dots-hyprland/tree/main/dots/.config/quickshell/ii): `dots/.config/quickshell/ii`
- [QoL features](https://github.com/end-4/dots-hyprland/tree/main/dots/.config/quickshell/ii/modules): `dots/.config/quickshell/ii/modules`
- [Material themes](https://github.com/end-4/dots-hyprland/tree/main/dots/.config/matugen/templates): `dots/.config/matugen/templates`
- [Shell widgets](https://github.com/end-4/dots-hyprland/tree/main/dots/.config/quickshell/ii/modules/ii): `dots/.config/quickshell/ii/modules/ii`

### Other components

- **Desktop user**
- **Wallpaper choice**

## Connections

- Desktop user → Setup command: runs install
- Desktop user → Hyprland configuration: uses desktop
- Desktop user → Quickshell shell: uses shell
- Desktop user → Window overview: views apps
- Desktop user → AI features: uses AI
- Desktop user → QoL features: uses features
- Wallpaper choice → Material themes: chooses palette
- Quickshell shell → Shell widgets: provides widgets
