# souandresouza/cadrocspace architecture

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

## Overview

Cadroc is a personal Arch Linux Wayland desktop setup centered on mangowm. Its documented workflow is to install the selected packages, deploy configuration into the user’s config directory, optionally generate a wallpaper-based theme, then use the configured desktop and its support scripts. The graph preserves the main desktop components and documented monitor, idle, and theme workflows. Source excerpts were unavailable, so relationships are limited to those stated in the README.

Main entry points: [`deploy.sh`](https://github.com/souandresouza/cadrocspace/blob/main/deploy.sh) (Config deploy), [`.config/scripts/run-scripts.sh`](https://github.com/souandresouza/cadrocspace/blob/main/.config/scripts/run-scripts.sh) (Theme generation), [`.config/mango/bind.conf`](https://github.com/souandresouza/cadrocspace/blob/main/.config/mango/bind.conf) (Mango bindings), [`.config/mango/config.conf`](https://github.com/souandresouza/cadrocspace/blob/main/.config/mango/config.conf) (Mango compositor)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_setup["Setup and themes"]
  node_install["Package install<br/>[install.sh]"]
  node_deploy["Config deploy<br/>[deploy.sh]"]
  node_defaults["Theme defaults"]
  node_wallpaper["Wallpaper files<br/>[wallpapers]"]
  node_themegen["Theme generation<br/>[run-scripts.sh]"]
end

subgraph group_session["Desktop session"]
  node_mango["Mango compositor<br/>[config.conf]"]
  node_mango_binds["Mango bindings<br/>[bind.conf]"]
  node_waybar["Waybar<br/>[waybar.jsonc]"]
  node_swayidle["Idle handling<br/>[config]"]
  node_swaync["Notifications<br/>[config.json]"]
  node_swaylock["Screen locking"]
end

subgraph group_tools["Desktop tools"]
  node_fuzzel["App launcher<br/>[fuzzel.ini]"]
  node_kitty["Terminal<br/>[kitty.conf]"]
  node_cava["Audio visualizer<br/>[config]"]
end

subgraph group_scripts["Support scripts"]
  node_scripts["Shared utilities<br/>[scripts]"]
  node_color_scripts["App color generators<br/>[colors]"]
  node_monitor_script["Monitor detection<br/>[detect-monitors.sh]"]
  node_mango_keys["Mango key helper<br/>[mango-keys.sh]"]
end

node_user(("Desktop user"))

node_user -->|"installs packages"| node_install
node_user -->|"deploys configuration"| node_deploy
node_deploy -->|"seeds missing themes"| node_defaults
node_deploy -->|"runs with generate"| node_themegen
node_themegen -->|"themes from wallpaper"| node_wallpaper
node_themegen -->|"renders app palettes"| node_color_scripts
node_user -->|"detects monitor rules"| node_monitor_script
node_user -->|"uses desktop session"| node_mango
node_mango -->|"uses bindings"| node_mango_binds
node_user -->|"uses desktop bar"| node_waybar
node_user -->|"uses idle handling"| node_swayidle
node_user -->|"uses notifications"| node_swaync
node_user -->|"uses screen lock"| node_swaylock
node_user -->|"launches applications"| node_fuzzel
node_user -->|"uses terminal"| node_kitty
node_user -->|"views audio levels"| node_cava
node_mango_binds -->|"invokes shared scripts"| node_scripts
node_mango_binds -->|"uses Mango helper"| node_mango_keys

click node_install "https://github.com/souandresouza/cadrocspace/blob/main/install.sh"
click node_deploy "https://github.com/souandresouza/cadrocspace/blob/main/deploy.sh"
click node_defaults "https://github.com/souandresouza/cadrocspace/tree/main/defaults"
click node_wallpaper "https://github.com/souandresouza/cadrocspace/tree/main/.config/wallpapers"
click node_themegen "https://github.com/souandresouza/cadrocspace/blob/main/.config/scripts/run-scripts.sh"
click node_mango "https://github.com/souandresouza/cadrocspace/blob/main/.config/mango/config.conf"
click node_mango_binds "https://github.com/souandresouza/cadrocspace/blob/main/.config/mango/bind.conf"
click node_waybar "https://github.com/souandresouza/cadrocspace/blob/main/defaults/mango/waybar.jsonc"
click node_swayidle "https://github.com/souandresouza/cadrocspace/blob/main/.config/swayidle/config"
click node_swaync "https://github.com/souandresouza/cadrocspace/blob/main/.config/swaync/config.json"
click node_swaylock "https://github.com/souandresouza/cadrocspace/blob/main/defaults/swaylock/config"
click node_fuzzel "https://github.com/souandresouza/cadrocspace/blob/main/.config/fuzzel/fuzzel.ini"
click node_kitty "https://github.com/souandresouza/cadrocspace/blob/main/.config/kitty/kitty.conf"
click node_cava "https://github.com/souandresouza/cadrocspace/blob/main/.config/cava/config"
click node_scripts "https://github.com/souandresouza/cadrocspace/tree/main/.config/scripts"
click node_color_scripts "https://github.com/souandresouza/cadrocspace/tree/main/.config/scripts/colors"
click node_monitor_script "https://github.com/souandresouza/cadrocspace/blob/main/.config/scripts/detect-monitors.sh"
click node_mango_keys "https://github.com/souandresouza/cadrocspace/blob/main/.config/mango/scripts/mango-keys.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_install,node_deploy,node_defaults,node_wallpaper,node_themegen,node_user toneBlue
class node_mango,node_mango_binds,node_waybar,node_swayidle,node_swaync,node_swaylock toneAmber
class node_fuzzel,node_kitty,node_cava toneMint
class node_scripts,node_color_scripts,node_monitor_script,node_mango_keys toneRose
```

## Components

### Setup and themes

- [Package install](https://github.com/souandresouza/cadrocspace/blob/main/install.sh): `install.sh`
- [Config deploy](https://github.com/souandresouza/cadrocspace/blob/main/deploy.sh): `deploy.sh`
- [Theme defaults](https://github.com/souandresouza/cadrocspace/tree/main/defaults): `defaults`
- [Wallpaper files](https://github.com/souandresouza/cadrocspace/tree/main/.config/wallpapers): `.config/wallpapers`
- [Theme generation](https://github.com/souandresouza/cadrocspace/blob/main/.config/scripts/run-scripts.sh): `.config/scripts/run-scripts.sh`

### Desktop session

- [Mango compositor](https://github.com/souandresouza/cadrocspace/blob/main/.config/mango/config.conf): `.config/mango/config.conf`
- [Mango bindings](https://github.com/souandresouza/cadrocspace/blob/main/.config/mango/bind.conf): `.config/mango/bind.conf`
- [Waybar](https://github.com/souandresouza/cadrocspace/blob/main/defaults/mango/waybar.jsonc): `defaults/mango/waybar.jsonc`
- [Idle handling](https://github.com/souandresouza/cadrocspace/blob/main/.config/swayidle/config): `.config/swayidle/config`
- [Notifications](https://github.com/souandresouza/cadrocspace/blob/main/.config/swaync/config.json): `.config/swaync/config.json`
- [Screen locking](https://github.com/souandresouza/cadrocspace/blob/main/defaults/swaylock/config): `defaults/swaylock/config`

### Desktop tools

- [App launcher](https://github.com/souandresouza/cadrocspace/blob/main/.config/fuzzel/fuzzel.ini): `.config/fuzzel/fuzzel.ini`
- [Terminal](https://github.com/souandresouza/cadrocspace/blob/main/.config/kitty/kitty.conf): `.config/kitty/kitty.conf`
- [Audio visualizer](https://github.com/souandresouza/cadrocspace/blob/main/.config/cava/config): `.config/cava/config`

### Support scripts

- [Shared utilities](https://github.com/souandresouza/cadrocspace/tree/main/.config/scripts): `.config/scripts`
- [App color generators](https://github.com/souandresouza/cadrocspace/tree/main/.config/scripts/colors): `.config/scripts/colors`
- [Monitor detection](https://github.com/souandresouza/cadrocspace/blob/main/.config/scripts/detect-monitors.sh): `.config/scripts/detect-monitors.sh`
- [Mango key helper](https://github.com/souandresouza/cadrocspace/blob/main/.config/mango/scripts/mango-keys.sh): `.config/mango/scripts/mango-keys.sh`

### Other components

- **Desktop user**

## Connections

- Desktop user → Package install: installs packages (evidence: `README.md`)
- Desktop user → Config deploy: deploys configuration (evidence: `README.md`)
- Config deploy → Theme defaults: seeds missing themes (evidence: `README.md`)
- Config deploy → Theme generation: runs with generate (evidence: `README.md`)
- Theme generation → Wallpaper files: themes from wallpaper (evidence: `README.md`)
- Theme generation → App color generators: renders app palettes (evidence: `README.md`)
- Desktop user → Monitor detection: detects monitor rules (evidence: `README.md`)
- Desktop user → Mango compositor: uses desktop session (evidence: `README.md`)
- Mango compositor → Mango bindings: uses bindings (evidence: `README.md`)
- Desktop user → Waybar: uses desktop bar (evidence: `README.md`)
- Desktop user → Idle handling: uses idle handling (evidence: `README.md`)
- Desktop user → Notifications: uses notifications (evidence: `README.md`)
- Desktop user → Screen locking: uses screen lock (evidence: `README.md`)
- Desktop user → App launcher: launches applications (evidence: `README.md`)
- Desktop user → Terminal: uses terminal (evidence: `README.md`)
- Desktop user → Audio visualizer: views audio levels (evidence: `README.md`)
- Mango bindings → Shared utilities: invokes shared scripts (evidence: `README.md`)
- Mango bindings → Mango key helper: uses Mango helper (evidence: `README.md`)
