# hrabid/dotfiles architecture

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

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

## Overview

This repository is a chezmoi-managed personal Linux configuration and helper-command collection. The main workflow is to apply the dotfiles, source the shell setup, and optionally run a package-manager-specific installer; graphical setup adds a configured Hyprland desktop and supporting applications. The tree shows substantial configuration areas for themes, launchers, notifications, media, and Neovim, but their runtime wiring was not sampled. The sampled Waybar monitor reads local system metrics and emits JSON updates for Waybar.

Main entry points: [`dot_bashrc`](https://github.com/hrabid/dotfiles/blob/master/dot_bashrc) (Shell environment), [`dot_config/waybar/scripts/executable_sysmon.py`](https://github.com/hrabid/dotfiles/blob/master/dot_config/waybar/scripts/executable_sysmon.py) (System monitor), [`dot_bin`](https://github.com/hrabid/dotfiles/tree/master/dot_bin) (Package installers)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_setup["Setup and shell"]
  node_shell["Shell environment"]
  node_pkg_install["Package installers"]
  node_shell_tools["Shell helpers"]
end

subgraph group_desktop["Desktop session"]
  node_hyprland["Hyprland session<br/>[hyprland.lua]"]
  node_waybar["Waybar status bar<br/>[config.jsonc]"]
  node_sysmon["System monitor"]
  node_notifications["Notifications<br/>[config.json]"]
  node_launcher["Rofi launchers<br/>[launcher.rasi]"]
  node_power_menu["Power menu"]
end

subgraph group_appearance["Appearance and themes"]
  node_theme_engine["Matugen themes<br/>[config.toml]"]
  node_terminal["Terminal themes<br/>[alacritty.toml]"]
  node_gtk_theme["GTK appearance<br/>[settings.ini]"]
end

subgraph group_apps["Applications"]
  node_nvim["Neovim setup<br/>[init.lua]"]
  node_mpv["MPV extensions<br/>[main.lua]"]
end

node_user(("User"))
node_chezmoi["chezmoi"]
node_waybar_actor["Waybar runtime"]

node_user -->|"runs apply"| node_chezmoi
node_chezmoi -->|"applies dotfiles"| node_shell
node_user -->|"sources setup"| node_shell
node_user -->|"runs installer"| node_pkg_install
node_sysmon -->|"emits JSON"| node_waybar_actor

click node_shell "https://github.com/hrabid/dotfiles/blob/master/dot_bashrc"
click node_pkg_install "https://github.com/hrabid/dotfiles/tree/master/dot_bin"
click node_shell_tools "https://github.com/hrabid/dotfiles/tree/master/dot_config/shell"
click node_hyprland "https://github.com/hrabid/dotfiles/blob/master/dot_config/hypr/hyprland.lua"
click node_waybar "https://github.com/hrabid/dotfiles/blob/master/dot_config/waybar/config.jsonc"
click node_sysmon "https://github.com/hrabid/dotfiles/blob/master/dot_config/waybar/scripts/executable_sysmon.py"
click node_notifications "https://github.com/hrabid/dotfiles/blob/master/dot_config/swaync/config.json"
click node_launcher "https://github.com/hrabid/dotfiles/blob/master/dot_config/rofi/launcher.rasi"
click node_power_menu "https://github.com/hrabid/dotfiles/blob/master/dot_config/wlogout/layout"
click node_theme_engine "https://github.com/hrabid/dotfiles/blob/master/dot_config/matugen/config.toml"
click node_terminal "https://github.com/hrabid/dotfiles/blob/master/dot_config/alacritty/alacritty.toml"
click node_gtk_theme "https://github.com/hrabid/dotfiles/blob/master/dot_config/gtk-3.0/settings.ini"
click node_nvim "https://github.com/hrabid/dotfiles/blob/master/dot_config/nvim/init.lua"
click node_mpv "https://github.com/hrabid/dotfiles/blob/master/dot_config/mpv/scripts/ytosc/main.lua"

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_shell,node_pkg_install,node_shell_tools,node_user toneBlue
class node_hyprland,node_waybar,node_sysmon,node_notifications,node_launcher,node_power_menu toneAmber
class node_theme_engine,node_terminal,node_gtk_theme toneMint
class node_nvim,node_mpv toneRose
class node_chezmoi,node_waybar_actor toneIndigo
```

## Components

### Setup and shell

- [Shell environment](https://github.com/hrabid/dotfiles/blob/master/dot_bashrc): `dot_bashrc`
- [Package installers](https://github.com/hrabid/dotfiles/tree/master/dot_bin): `dot_bin`
- [Shell helpers](https://github.com/hrabid/dotfiles/tree/master/dot_config/shell): `dot_config/shell`

### Desktop session

- [Hyprland session](https://github.com/hrabid/dotfiles/blob/master/dot_config/hypr/hyprland.lua): `dot_config/hypr/hyprland.lua`
- [Waybar status bar](https://github.com/hrabid/dotfiles/blob/master/dot_config/waybar/config.jsonc): `dot_config/waybar/config.jsonc`
- [System monitor](https://github.com/hrabid/dotfiles/blob/master/dot_config/waybar/scripts/executable_sysmon.py): `dot_config/waybar/scripts/executable_sysmon.py`
- [Notifications](https://github.com/hrabid/dotfiles/blob/master/dot_config/swaync/config.json): `dot_config/swaync/config.json`
- [Rofi launchers](https://github.com/hrabid/dotfiles/blob/master/dot_config/rofi/launcher.rasi): `dot_config/rofi/launcher.rasi`
- [Power menu](https://github.com/hrabid/dotfiles/blob/master/dot_config/wlogout/layout): `dot_config/wlogout/layout`

### Appearance and themes

- [Matugen themes](https://github.com/hrabid/dotfiles/blob/master/dot_config/matugen/config.toml): `dot_config/matugen/config.toml`
- [Terminal themes](https://github.com/hrabid/dotfiles/blob/master/dot_config/alacritty/alacritty.toml): `dot_config/alacritty/alacritty.toml`
- [GTK appearance](https://github.com/hrabid/dotfiles/blob/master/dot_config/gtk-3.0/settings.ini): `dot_config/gtk-3.0/settings.ini`

### Applications

- [Neovim setup](https://github.com/hrabid/dotfiles/blob/master/dot_config/nvim/init.lua): `dot_config/nvim/init.lua`
- [MPV extensions](https://github.com/hrabid/dotfiles/blob/master/dot_config/mpv/scripts/ytosc/main.lua): `dot_config/mpv/scripts/ytosc/main.lua`

### Other components

- **User**
- **chezmoi**
- **Waybar runtime**

## Connections

- User → chezmoi: runs apply (evidence: `README.md`)
- chezmoi → Shell environment: applies dotfiles (evidence: `README.md`)
- User → Shell environment: sources setup (evidence: `README.md`)
- User → Package installers: runs installer (evidence: `README.md`)
- System monitor → Waybar runtime: emits JSON (evidence: `dot_config/waybar/scripts/executable_sysmon.py`)
