# thefoodiee/minimalistic-dotfiles architecture

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

- Interactive diagram: https://gitdiagram.com/thefoodiee/minimalistic-dotfiles
- Repository: https://github.com/thefoodiee/minimalistic-dotfiles

## Overview

This repository is a set of Arch Linux desktop dotfiles and an installer. The documented user workflow is to run the installer on a fresh Arch system, which sets up a Hyprland desktop; the configured desktop then provides window management, shell, utilities, and theming. The README documents wallpaper-driven Pywal theming, but source excerpts were unavailable, so runtime links beyond those documented are omitted.

Main entry points: [`install.sh`](https://github.com/thefoodiee/minimalistic-dotfiles/blob/main/install.sh) (Desktop installer), [`wal/.config/wal/templates`](https://github.com/thefoodiee/minimalistic-dotfiles/tree/main/wal/.config/wal/templates) (Pywal templates), [`hypr/.config/hypr/hyprland.lua`](https://github.com/thefoodiee/minimalistic-dotfiles/blob/main/hypr/.config/hypr/hyprland.lua) (Hyprland setup), [`niri/.config/niri/config.kdl`](https://github.com/thefoodiee/minimalistic-dotfiles/blob/main/niri/.config/niri/config.kdl) (Niri setup)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_setup["Setup"]
  node_installer["Desktop installer<br/>[install.sh]"]
end

subgraph group_desktop["Desktop"]
  node_hyprland["Hyprland setup<br/>[hyprland.lua]"]
  node_niri["Niri setup<br/>[config.kdl]"]
  node_waybar["Status bar<br/>[config.jsonc]"]
  node_notifications["Notifications<br/>[config.json]"]
  node_lockscreen["Lockscreen<br/>[lock_shell.qml]"]
end

subgraph group_appearance["Theming"]
  node_wallpapers["Wallpaper tools<br/>[wallselect]"]
  node_pywal["Pywal templates<br/>[templates]"]
  node_gtk["GTK theme<br/>[gtk.css]"]
  node_qt["Kvantum themes<br/>[Kvantum]"]
  node_matugen["Matugen templates<br/>[templates]"]
  node_wallust["Wallust templates<br/>[templates]"]
end

subgraph group_workflow["User Tools"]
  node_terminal["Terminal setup<br/>[kitty.conf]"]
  node_shell["Zsh setup<br/>[.zshrc]"]
  node_editor["Neovim setup<br/>[init.lua]"]
end

node_user(("Arch user"))
node_desktop_result["Configured desktop"]

node_user -->|"runs"| node_installer
node_installer -->|"sets up"| node_hyprland
node_installer -->|"installs packages"| node_desktop_result
node_wallpapers -->|"supplies wallpaper"| node_pywal
node_pywal -->|"generates colors"| node_gtk
node_pywal -->|"generates colors"| node_qt
node_hyprland -->|"provides window management"| node_desktop_result
node_niri -.->|"provides alternative compositor"| node_desktop_result
node_waybar -->|"provides status bar"| node_desktop_result
node_notifications -->|"provides notifications"| node_desktop_result
node_lockscreen -.->|"provides lockscreen"| node_desktop_result
node_terminal -->|"provides terminal"| node_desktop_result
node_shell -->|"provides shell"| node_desktop_result
node_editor -->|"provides editor"| node_desktop_result
node_matugen -.->|"offers color templates"| node_desktop_result
node_wallust -.->|"offers color templates"| node_desktop_result

click node_installer "https://github.com/thefoodiee/minimalistic-dotfiles/blob/main/install.sh"
click node_hyprland "https://github.com/thefoodiee/minimalistic-dotfiles/blob/main/hypr/.config/hypr/hyprland.lua"
click node_niri "https://github.com/thefoodiee/minimalistic-dotfiles/blob/main/niri/.config/niri/config.kdl"
click node_waybar "https://github.com/thefoodiee/minimalistic-dotfiles/blob/main/waybar/.config/waybar/config.jsonc"
click node_notifications "https://github.com/thefoodiee/minimalistic-dotfiles/blob/main/swaync/.config/swaync/config.json"
click node_lockscreen "https://github.com/thefoodiee/minimalistic-dotfiles/blob/main/quickshell/.config/quickshell/lockscreen/lock_shell.qml"
click node_terminal "https://github.com/thefoodiee/minimalistic-dotfiles/blob/main/kitty/.config/kitty/kitty.conf"
click node_shell "https://github.com/thefoodiee/minimalistic-dotfiles/blob/main/zsh/.zshrc"
click node_editor "https://github.com/thefoodiee/minimalistic-dotfiles/blob/main/nvim/.config/nvim/init.lua"
click node_wallpapers "https://github.com/thefoodiee/minimalistic-dotfiles/blob/main/bin/.local/bin/wallselect"
click node_pywal "https://github.com/thefoodiee/minimalistic-dotfiles/tree/main/wal/.config/wal/templates"
click node_gtk "https://github.com/thefoodiee/minimalistic-dotfiles/blob/main/gtk4/.config/gtk-4.0/gtk.css"
click node_qt "https://github.com/thefoodiee/minimalistic-dotfiles/tree/main/kvantum/.config/Kvantum"
click node_matugen "https://github.com/thefoodiee/minimalistic-dotfiles/tree/main/matugen/.config/matugen/templates"
click node_wallust "https://github.com/thefoodiee/minimalistic-dotfiles/tree/main/wallust/.config/wallust/templates"

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,node_niri,node_waybar,node_notifications,node_lockscreen toneAmber
class node_wallpapers,node_pywal,node_gtk,node_qt,node_matugen,node_wallust toneMint
class node_terminal,node_shell,node_editor toneRose
class node_desktop_result toneIndigo
```

## Components

### Setup

- [Desktop installer](https://github.com/thefoodiee/minimalistic-dotfiles/blob/main/install.sh): `install.sh`

### Desktop

- [Hyprland setup](https://github.com/thefoodiee/minimalistic-dotfiles/blob/main/hypr/.config/hypr/hyprland.lua): `hypr/.config/hypr/hyprland.lua`
- [Niri setup](https://github.com/thefoodiee/minimalistic-dotfiles/blob/main/niri/.config/niri/config.kdl): `niri/.config/niri/config.kdl`
- [Status bar](https://github.com/thefoodiee/minimalistic-dotfiles/blob/main/waybar/.config/waybar/config.jsonc): `waybar/.config/waybar/config.jsonc`
- [Notifications](https://github.com/thefoodiee/minimalistic-dotfiles/blob/main/swaync/.config/swaync/config.json): `swaync/.config/swaync/config.json`
- [Lockscreen](https://github.com/thefoodiee/minimalistic-dotfiles/blob/main/quickshell/.config/quickshell/lockscreen/lock_shell.qml): `quickshell/.config/quickshell/lockscreen/lock_shell.qml`

### Theming

- [Wallpaper tools](https://github.com/thefoodiee/minimalistic-dotfiles/blob/main/bin/.local/bin/wallselect): `bin/.local/bin/wallselect`
- [Pywal templates](https://github.com/thefoodiee/minimalistic-dotfiles/tree/main/wal/.config/wal/templates): `wal/.config/wal/templates`
- [GTK theme](https://github.com/thefoodiee/minimalistic-dotfiles/blob/main/gtk4/.config/gtk-4.0/gtk.css): `gtk4/.config/gtk-4.0/gtk.css`
- [Kvantum themes](https://github.com/thefoodiee/minimalistic-dotfiles/tree/main/kvantum/.config/Kvantum): `kvantum/.config/Kvantum`
- [Matugen templates](https://github.com/thefoodiee/minimalistic-dotfiles/tree/main/matugen/.config/matugen/templates): `matugen/.config/matugen/templates`
- [Wallust templates](https://github.com/thefoodiee/minimalistic-dotfiles/tree/main/wallust/.config/wallust/templates): `wallust/.config/wallust/templates`

### User Tools

- [Terminal setup](https://github.com/thefoodiee/minimalistic-dotfiles/blob/main/kitty/.config/kitty/kitty.conf): `kitty/.config/kitty/kitty.conf`
- [Zsh setup](https://github.com/thefoodiee/minimalistic-dotfiles/blob/main/zsh/.zshrc): `zsh/.zshrc`
- [Neovim setup](https://github.com/thefoodiee/minimalistic-dotfiles/blob/main/nvim/.config/nvim/init.lua): `nvim/.config/nvim/init.lua`

### Other components

- **Arch user**
- **Configured desktop**

## Connections

- Arch user → Desktop installer: runs (evidence: `README.md`)
- Desktop installer → Hyprland setup: sets up (evidence: `README.md`)
- Desktop installer → Configured desktop: installs packages (evidence: `README.md`)
- Wallpaper tools → Pywal templates: supplies wallpaper (evidence: `README.md`)
- Pywal templates → GTK theme: generates colors (evidence: `README.md`)
- Pywal templates → Kvantum themes: generates colors (evidence: `README.md`)
- Hyprland setup → Configured desktop: provides window management (evidence: `README.md`)
- Niri setup → Configured desktop: provides alternative compositor
- Status bar → Configured desktop: provides status bar (evidence: `README.md`)
- Notifications → Configured desktop: provides notifications (evidence: `README.md`)
- Lockscreen → Configured desktop: provides lockscreen
- Terminal setup → Configured desktop: provides terminal (evidence: `README.md`)
- Zsh setup → Configured desktop: provides shell (evidence: `README.md`)
- Neovim setup → Configured desktop: provides editor (evidence: `README.md`)
- Matugen templates → Configured desktop: offers color templates
- Wallust templates → Configured desktop: offers color templates
