# stannorbvb-cmd/cpunk architecture

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

- Interactive diagram: https://gitdiagram.com/stannorbvb-cmd/cpunk
- Repository: https://github.com/stannorbvb-cmd/cpunk

## Overview

CpUnk is a configuration-and-asset theme for Omarchy desktops, emphasizing a cyberpunk red-and-black look and consistent styling across desktop components and applications. The user-facing workflow is to use the theme’s files with the corresponding desktop components and apps; these components read their own configuration rather than forming a repository-defined runtime pipeline. The tree and README identify the files and supported ecosystem, but no source excerpts establish installation or cross-file wiring, so the graph shows only per-component configuration reads.

Main entry points: [`hyprland.conf`](https://github.com/stannorbvb-cmd/cpunk/blob/main/hyprland.conf) (Hyprland config), [`hyprlock.conf`](https://github.com/stannorbvb-cmd/cpunk/blob/main/hyprlock.conf) (Hyprlock config), [`mako.ini`](https://github.com/stannorbvb-cmd/cpunk/blob/main/mako.ini) (Mako config), [`waybar.css`](https://github.com/stannorbvb-cmd/cpunk/blob/main/waybar.css) (Waybar style)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_desktop["Desktop styling"]
  node_hyprland_conf["Hyprland config<br/>[hyprland.conf]"]
  node_lock["Hyprlock config<br/>[hyprlock.conf]"]
  node_mako["Mako config<br/>[mako.ini]"]
  node_waybar["Waybar style<br/>[waybar.css]"]
  node_swayosd["SwayOSD style<br/>[swayosd.css]"]
  node_walker["Walker style<br/>[walker.css]"]
  node_wofi["Wofi style<br/>[wofi.css]"]
end

subgraph group_apps["Application styling"]
  node_alacritty["Alacritty config<br/>[alacritty.toml]"]
  node_ghostty["Ghostty config<br/>[ghostty.conf]"]
  node_kitty["Kitty config<br/>[kitty.conf]"]
  node_neovim["Neovim config<br/>[neovim.lua]"]
  node_chromium["Chromium theme<br/>[chromium.theme]"]
  node_vscode["VS Code theme<br/>[vscode.json]"]
  node_warp["Warp config<br/>[warp.yaml]"]
  node_btop["btop theme<br/>[btop.theme]"]
end

subgraph group_shared["Shared theme assets"]
  node_colors["Color palette<br/>[colors.toml]"]
  node_icons["Icon theme<br/>[icons.theme]"]
  node_backgrounds["Background images"]
  node_aether["Aether CSS override"]
end

node_user(("Desktop user"))
node_hyprland["Hyprland"]

node_user -->|"uses desktop"| node_hyprland
node_hyprland -->|"reads config"| node_hyprland_conf
node_user -->|"uses theme"| node_lock
node_user -->|"uses theme"| node_mako
node_user -->|"uses theme"| node_waybar
node_user -->|"uses theme"| node_swayosd
node_user -->|"uses theme"| node_walker
node_user -->|"uses theme"| node_wofi
node_user -->|"uses config"| node_alacritty
node_user -->|"uses config"| node_ghostty
node_user -->|"uses config"| node_kitty
node_user -->|"uses config"| node_neovim
node_user -->|"uses theme"| node_chromium
node_user -->|"uses theme"| node_vscode
node_user -->|"uses config"| node_warp
node_user -->|"uses theme"| node_btop

click node_hyprland_conf "https://github.com/stannorbvb-cmd/cpunk/blob/main/hyprland.conf"
click node_lock "https://github.com/stannorbvb-cmd/cpunk/blob/main/hyprlock.conf"
click node_mako "https://github.com/stannorbvb-cmd/cpunk/blob/main/mako.ini"
click node_waybar "https://github.com/stannorbvb-cmd/cpunk/blob/main/waybar.css"
click node_swayosd "https://github.com/stannorbvb-cmd/cpunk/blob/main/swayosd.css"
click node_walker "https://github.com/stannorbvb-cmd/cpunk/blob/main/walker.css"
click node_wofi "https://github.com/stannorbvb-cmd/cpunk/blob/main/wofi.css"
click node_alacritty "https://github.com/stannorbvb-cmd/cpunk/blob/main/alacritty.toml"
click node_ghostty "https://github.com/stannorbvb-cmd/cpunk/blob/main/ghostty.conf"
click node_kitty "https://github.com/stannorbvb-cmd/cpunk/blob/main/kitty.conf"
click node_neovim "https://github.com/stannorbvb-cmd/cpunk/blob/main/neovim.lua"
click node_chromium "https://github.com/stannorbvb-cmd/cpunk/blob/main/chromium.theme"
click node_vscode "https://github.com/stannorbvb-cmd/cpunk/blob/main/vscode.json"
click node_warp "https://github.com/stannorbvb-cmd/cpunk/blob/main/warp.yaml"
click node_btop "https://github.com/stannorbvb-cmd/cpunk/blob/main/btop.theme"
click node_colors "https://github.com/stannorbvb-cmd/cpunk/blob/main/colors.toml"
click node_icons "https://github.com/stannorbvb-cmd/cpunk/blob/main/icons.theme"
click node_backgrounds "https://github.com/stannorbvb-cmd/cpunk/tree/main/backgrounds"
click node_aether "https://github.com/stannorbvb-cmd/cpunk/blob/main/aether.override.css"

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_hyprland_conf,node_lock,node_mako,node_waybar,node_swayosd,node_walker,node_wofi,node_user toneBlue
class node_alacritty,node_ghostty,node_kitty,node_neovim,node_chromium,node_vscode,node_warp,node_btop toneAmber
class node_colors,node_icons,node_backgrounds,node_aether toneMint
class node_hyprland toneIndigo
```

## Components

### Desktop styling

- [Hyprland config](https://github.com/stannorbvb-cmd/cpunk/blob/main/hyprland.conf): `hyprland.conf`
- [Hyprlock config](https://github.com/stannorbvb-cmd/cpunk/blob/main/hyprlock.conf): `hyprlock.conf`
- [Mako config](https://github.com/stannorbvb-cmd/cpunk/blob/main/mako.ini): `mako.ini`
- [Waybar style](https://github.com/stannorbvb-cmd/cpunk/blob/main/waybar.css): `waybar.css`
- [SwayOSD style](https://github.com/stannorbvb-cmd/cpunk/blob/main/swayosd.css): `swayosd.css`
- [Walker style](https://github.com/stannorbvb-cmd/cpunk/blob/main/walker.css): `walker.css`
- [Wofi style](https://github.com/stannorbvb-cmd/cpunk/blob/main/wofi.css): `wofi.css`

### Application styling

- [Alacritty config](https://github.com/stannorbvb-cmd/cpunk/blob/main/alacritty.toml): `alacritty.toml`
- [Ghostty config](https://github.com/stannorbvb-cmd/cpunk/blob/main/ghostty.conf): `ghostty.conf`
- [Kitty config](https://github.com/stannorbvb-cmd/cpunk/blob/main/kitty.conf): `kitty.conf`
- [Neovim config](https://github.com/stannorbvb-cmd/cpunk/blob/main/neovim.lua): `neovim.lua`
- [Chromium theme](https://github.com/stannorbvb-cmd/cpunk/blob/main/chromium.theme): `chromium.theme`
- [VS Code theme](https://github.com/stannorbvb-cmd/cpunk/blob/main/vscode.json): `vscode.json`
- [Warp config](https://github.com/stannorbvb-cmd/cpunk/blob/main/warp.yaml): `warp.yaml`
- [btop theme](https://github.com/stannorbvb-cmd/cpunk/blob/main/btop.theme): `btop.theme`

### Shared theme assets

- [Color palette](https://github.com/stannorbvb-cmd/cpunk/blob/main/colors.toml): `colors.toml`
- [Icon theme](https://github.com/stannorbvb-cmd/cpunk/blob/main/icons.theme): `icons.theme`
- [Background images](https://github.com/stannorbvb-cmd/cpunk/tree/main/backgrounds): `backgrounds`
- [Aether CSS override](https://github.com/stannorbvb-cmd/cpunk/blob/main/aether.override.css): `aether.override.css`

### Other components

- **Desktop user**
- **Hyprland**

## Connections

- Desktop user → Hyprland: uses desktop
- Hyprland → Hyprland config: reads config
- Desktop user → Hyprlock config: uses theme
- Desktop user → Mako config: uses theme
- Desktop user → Waybar style: uses theme
- Desktop user → SwayOSD style: uses theme
- Desktop user → Walker style: uses theme
- Desktop user → Wofi style: uses theme
- Desktop user → Alacritty config: uses config
- Desktop user → Ghostty config: uses config
- Desktop user → Kitty config: uses config
- Desktop user → Neovim config: uses config
- Desktop user → Chromium theme: uses theme
- Desktop user → VS Code theme: uses theme
- Desktop user → Warp config: uses config
- Desktop user → btop theme: uses theme