# harshrajsachan/stow-dotfiles architecture

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

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

## Overview

This repository is a personal Linux desktop configuration collection, not an application with a single implemented runtime pipeline. Its user-facing result is a configured desktop spanning window management, appearance, terminal and editor setup, and media tools; the theme directory also provides coordinated per-application theme files. The tree supports these subsystem boundaries, but no README or source excerpts were provided, so relationships such as how themes are applied or scripts invoke other tools cannot be verified and are omitted.

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_desktop["Desktop Shell"]
  node_i3["Window manager<br/>[config]"]
  node_i3scripts["Desktop scripts<br/>[scripts]"]
  node_polybar["Status bar<br/>[config.ini]"]
  node_rofi["App launcher<br/>[rofi.conf]"]
end

subgraph group_appearance["Appearance"]
  node_themefiles["Theme collection<br/>[themes]"]
  node_picom["Compositor<br/>[picom.conf]"]
  node_dunst["Notifications<br/>[dunstrc]"]
end

subgraph group_work["Work Environment"]
  node_nvim["Editor setup<br/>[init.lua]"]
  node_shell["Shell setup<br/>[.bashrc]"]
  node_terminal["Terminal setup<br/>[kitty.conf]"]
  node_alacritty["Terminal emulator<br/>[alacritty.toml]"]
end

subgraph group_media["Media Tools"]
  node_mpd["Music server<br/>[mpd.conf]"]
  node_mpv["Media player<br/>[mpv.conf]"]
  node_cava["Audio visualizer<br/>[config]"]
end

subgraph group_system["System Utilities"]
  node_btop["Resource monitor<br/>[btop.conf]"]
  node_fastfetch["System summary<br/>[config.jsonc]"]
  node_flameshot["Screenshot tool<br/>[flameshot.ini]"]
end

node_user(("Desktop user"))

click node_i3 "https://github.com/harshrajsachan/stow-dotfiles/blob/main/i3/.config/i3/config"
click node_i3scripts "https://github.com/harshrajsachan/stow-dotfiles/tree/main/i3/.config/i3/scripts"
click node_polybar "https://github.com/harshrajsachan/stow-dotfiles/blob/main/polybar/.config/polybar/config.ini"
click node_rofi "https://github.com/harshrajsachan/stow-dotfiles/blob/main/rofi/.config/rofi/rofi.conf"
click node_themefiles "https://github.com/harshrajsachan/stow-dotfiles/tree/main/themes/.config/themes"
click node_picom "https://github.com/harshrajsachan/stow-dotfiles/blob/main/picom/.config/picom/picom.conf"
click node_dunst "https://github.com/harshrajsachan/stow-dotfiles/blob/main/dunst/.config/dunst/dunstrc"
click node_nvim "https://github.com/harshrajsachan/stow-dotfiles/blob/main/nvim/.config/nvim/init.lua"
click node_shell "https://github.com/harshrajsachan/stow-dotfiles/blob/main/bash/.bashrc"
click node_terminal "https://github.com/harshrajsachan/stow-dotfiles/blob/main/kitty/.config/kitty/kitty.conf"
click node_mpd "https://github.com/harshrajsachan/stow-dotfiles/blob/main/mpd/.config/mpd/mpd.conf"
click node_mpv "https://github.com/harshrajsachan/stow-dotfiles/blob/main/mpv/.config/mpv/mpv.conf"
click node_cava "https://github.com/harshrajsachan/stow-dotfiles/blob/main/cava/.config/cava/config"
click node_btop "https://github.com/harshrajsachan/stow-dotfiles/blob/main/btop/.config/btop/btop.conf"
click node_fastfetch "https://github.com/harshrajsachan/stow-dotfiles/blob/main/fastfetch/.config/fastfetch/config.jsonc"
click node_flameshot "https://github.com/harshrajsachan/stow-dotfiles/blob/main/flameshot/.config/flameshot/flameshot.ini"
click node_alacritty "https://github.com/harshrajsachan/stow-dotfiles/blob/main/alacritty/.config/alacritty/alacritty.toml"

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_i3,node_i3scripts,node_polybar,node_rofi,node_user toneBlue
class node_themefiles,node_picom,node_dunst toneAmber
class node_nvim,node_shell,node_terminal,node_alacritty toneMint
class node_mpd,node_mpv,node_cava toneRose
class node_btop,node_fastfetch,node_flameshot toneIndigo
```

## Components

### Desktop Shell

- [Window manager](https://github.com/harshrajsachan/stow-dotfiles/blob/main/i3/.config/i3/config): `i3/.config/i3/config`
- [Desktop scripts](https://github.com/harshrajsachan/stow-dotfiles/tree/main/i3/.config/i3/scripts): `i3/.config/i3/scripts`
- [Status bar](https://github.com/harshrajsachan/stow-dotfiles/blob/main/polybar/.config/polybar/config.ini): `polybar/.config/polybar/config.ini`
- [App launcher](https://github.com/harshrajsachan/stow-dotfiles/blob/main/rofi/.config/rofi/rofi.conf): `rofi/.config/rofi/rofi.conf`

### Appearance

- [Theme collection](https://github.com/harshrajsachan/stow-dotfiles/tree/main/themes/.config/themes): `themes/.config/themes`
- [Compositor](https://github.com/harshrajsachan/stow-dotfiles/blob/main/picom/.config/picom/picom.conf): `picom/.config/picom/picom.conf`
- [Notifications](https://github.com/harshrajsachan/stow-dotfiles/blob/main/dunst/.config/dunst/dunstrc): `dunst/.config/dunst/dunstrc`

### Work Environment

- [Editor setup](https://github.com/harshrajsachan/stow-dotfiles/blob/main/nvim/.config/nvim/init.lua): `nvim/.config/nvim/init.lua`
- [Shell setup](https://github.com/harshrajsachan/stow-dotfiles/blob/main/bash/.bashrc): `bash/.bashrc`
- [Terminal setup](https://github.com/harshrajsachan/stow-dotfiles/blob/main/kitty/.config/kitty/kitty.conf): `kitty/.config/kitty/kitty.conf`
- [Terminal emulator](https://github.com/harshrajsachan/stow-dotfiles/blob/main/alacritty/.config/alacritty/alacritty.toml): `alacritty/.config/alacritty/alacritty.toml`

### Media Tools

- [Music server](https://github.com/harshrajsachan/stow-dotfiles/blob/main/mpd/.config/mpd/mpd.conf): `mpd/.config/mpd/mpd.conf`
- [Media player](https://github.com/harshrajsachan/stow-dotfiles/blob/main/mpv/.config/mpv/mpv.conf): `mpv/.config/mpv/mpv.conf`
- [Audio visualizer](https://github.com/harshrajsachan/stow-dotfiles/blob/main/cava/.config/cava/config): `cava/.config/cava/config`

### System Utilities

- [Resource monitor](https://github.com/harshrajsachan/stow-dotfiles/blob/main/btop/.config/btop/btop.conf): `btop/.config/btop/btop.conf`
- [System summary](https://github.com/harshrajsachan/stow-dotfiles/blob/main/fastfetch/.config/fastfetch/config.jsonc): `fastfetch/.config/fastfetch/config.jsonc`
- [Screenshot tool](https://github.com/harshrajsachan/stow-dotfiles/blob/main/flameshot/.config/flameshot/flameshot.ini): `flameshot/.config/flameshot/flameshot.ini`

### Other components

- **Desktop user**
