# pikexx/dotfile architecture

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

## Overview

This repository is a personal desktop configuration collection, with a customized suckless terminal (st) as its substantial runtime component. The likely user workflow is interacting with a bspwm desktop through configured shortcuts, using Polybar for status and st for terminal sessions, with picom providing compositing. The README documents no capabilities or wiring, so desktop-component relationships are not asserted. The st relationships shown are limited to references recorded in the source index; unsampled runtime behavior is not expanded into unsupported call flows.

Main entry points: [`st/x.c`](https://github.com/pikexx/dotfile/blob/main/st/x.c) (X11 Frontend), [`st/st.h`](https://github.com/pikexx/dotfile/blob/main/st/st.h) (Terminal Interface), [`st/st.c`](https://github.com/pikexx/dotfile/blob/main/st/st.c) (Terminal Core), [`st/boxdraw.c`](https://github.com/pikexx/dotfile/blob/main/st/boxdraw.c) (Box Glyph Renderer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_desktop["Desktop Controls"]
  node_bspwm["Window Manager Config"]
  node_sxhkd["Shortcut Config"]
  node_picom["Compositor Config<br/>[picom.conf]"]
end

subgraph group_session["Session UI"]
  node_polybar["Bar Config<br/>[config.ini]"]
  node_player["Player Script<br/>[player.sh]"]
  node_shutdown["Shutdown Script<br/>[shut.sh]"]
end

subgraph group_terminal["Terminal Emulator"]
  node_stcore["Terminal Core<br/>[st.c]"]
  node_stx["X11 Frontend<br/>[x.c]"]
  node_stcontract["Terminal Interface<br/>[st.h]"]
  node_windowcontract["Window Interface<br/>[win.h]"]
  node_stconfig["Terminal Settings<br/>[config.h]"]
  node_argparse["Argument Macros<br/>[arg.h]"]
  node_boxdraw["Box Glyph Renderer<br/>[boxdraw.c]"]
  node_boxdata["Box Glyph Data<br/>[boxdraw_data.h]"]
end

node_user(("Desktop User"))

node_user -.->|"uses"| node_bspwm
node_user -.->|"uses"| node_sxhkd
node_user -.->|"views"| node_polybar
node_user -.->|"opens"| node_stx
node_stcore -->|"references"| node_stcontract
node_stcore -->|"references"| node_windowcontract
node_stx -->|"references"| node_stcontract
node_stx -->|"references"| node_windowcontract
node_stx -->|"references"| node_stconfig
node_stx -->|"references"| node_argparse
node_boxdraw -->|"references"| node_stcontract
node_boxdraw -->|"uses"| node_boxdata

click node_bspwm "https://github.com/pikexx/dotfile/blob/main/bspwm/bspwmrc"
click node_sxhkd "https://github.com/pikexx/dotfile/blob/main/sxhkd/sxhkdrc"
click node_picom "https://github.com/pikexx/dotfile/blob/main/picom.conf"
click node_polybar "https://github.com/pikexx/dotfile/blob/main/polybar/config.ini"
click node_player "https://github.com/pikexx/dotfile/blob/main/polybar/player.sh"
click node_shutdown "https://github.com/pikexx/dotfile/blob/main/polybar/shut.sh"
click node_stcore "https://github.com/pikexx/dotfile/blob/main/st/st.c"
click node_stx "https://github.com/pikexx/dotfile/blob/main/st/x.c"
click node_stcontract "https://github.com/pikexx/dotfile/blob/main/st/st.h"
click node_windowcontract "https://github.com/pikexx/dotfile/blob/main/st/win.h"
click node_stconfig "https://github.com/pikexx/dotfile/blob/main/st/config.h"
click node_argparse "https://github.com/pikexx/dotfile/blob/main/st/arg.h"
click node_boxdraw "https://github.com/pikexx/dotfile/blob/main/st/boxdraw.c"
click node_boxdata "https://github.com/pikexx/dotfile/blob/main/st/boxdraw_data.h"

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_bspwm,node_sxhkd,node_picom,node_user toneBlue
class node_polybar,node_player,node_shutdown toneAmber
class node_stcore,node_stx,node_stcontract,node_windowcontract,node_stconfig,node_argparse,node_boxdraw,node_boxdata toneMint
```

## Components

### Desktop Controls

- [Window Manager Config](https://github.com/pikexx/dotfile/blob/main/bspwm/bspwmrc): `bspwm/bspwmrc`
- [Shortcut Config](https://github.com/pikexx/dotfile/blob/main/sxhkd/sxhkdrc): `sxhkd/sxhkdrc`
- [Compositor Config](https://github.com/pikexx/dotfile/blob/main/picom.conf): `picom.conf`

### Session UI

- [Bar Config](https://github.com/pikexx/dotfile/blob/main/polybar/config.ini): `polybar/config.ini`
- [Player Script](https://github.com/pikexx/dotfile/blob/main/polybar/player.sh): `polybar/player.sh`
- [Shutdown Script](https://github.com/pikexx/dotfile/blob/main/polybar/shut.sh): `polybar/shut.sh`

### Terminal Emulator

- [Terminal Core](https://github.com/pikexx/dotfile/blob/main/st/st.c): `st/st.c`
- [X11 Frontend](https://github.com/pikexx/dotfile/blob/main/st/x.c): `st/x.c`
- [Terminal Interface](https://github.com/pikexx/dotfile/blob/main/st/st.h): `st/st.h`
- [Window Interface](https://github.com/pikexx/dotfile/blob/main/st/win.h): `st/win.h`
- [Terminal Settings](https://github.com/pikexx/dotfile/blob/main/st/config.h): `st/config.h`
- [Argument Macros](https://github.com/pikexx/dotfile/blob/main/st/arg.h): `st/arg.h`
- [Box Glyph Renderer](https://github.com/pikexx/dotfile/blob/main/st/boxdraw.c): `st/boxdraw.c`
- [Box Glyph Data](https://github.com/pikexx/dotfile/blob/main/st/boxdraw_data.h): `st/boxdraw_data.h`

### Other components

- **Desktop User**

## Connections

- Desktop User → Window Manager Config: uses
- Desktop User → Shortcut Config: uses
- Desktop User → Bar Config: views
- Desktop User → X11 Frontend: opens
- Terminal Core → Terminal Interface: references (evidence: `st/st.c`)
- Terminal Core → Window Interface: references (evidence: `st/st.c`)
- X11 Frontend → Terminal Interface: references (evidence: `st/x.c`)
- X11 Frontend → Window Interface: references (evidence: `st/x.c`)
- X11 Frontend → Terminal Settings: references (evidence: `st/x.c`)
- X11 Frontend → Argument Macros: references (evidence: `st/x.c`)
- Box Glyph Renderer → Terminal Interface: references (evidence: `st/boxdraw.c`)
- Box Glyph Renderer → Box Glyph Data: uses (evidence: `st/boxdraw.c`)
