# orysse/config architecture

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

- Interactive diagram: https://gitdiagram.com/orysse/config
- Repository: https://github.com/orysse/config

## Overview

This repository is a dendritic NixOS configuration for a ThinkPad, organized into host configuration, reusable system modules, application features, and optional profiles. Its user-facing result is a configured NixOS desktop: system foundations cover boot, networking, storage, and persistence, while feature modules configure the desktop and command-line environment. The README documents declarative disk setup, reboot persistence, and encrypted secrets. Source excerpts were unavailable, so links are limited to relationships explicitly described in the README; paths identify the corresponding directories in the tree.

Main entry points: [`modules/hosts/thinkpad`](https://github.com/orysse/config/tree/main/modules/hosts/thinkpad) (ThinkPad host), [`modules/flavors/secrets`](https://github.com/orysse/config/tree/main/modules/flavors/secrets) (Secret decryption), [`modules/flavors/dev`](https://github.com/orysse/config/tree/main/modules/flavors/dev) (Development profile), [`modules/flavors/infra`](https://github.com/orysse/config/tree/main/modules/flavors/infra) (Infrastructure profile)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_host["Host configuration"]
  node_hostcfg["ThinkPad host"]
  node_flakeparts["Flake parts<br/>[parts.nix]"]
end

subgraph group_system["System foundation"]
  node_boot["Boot configuration<br/>[boot.nix]"]
  node_core["Core system"]
  node_disk["Disk layout<br/>[_disko.nix]"]
  node_persistence["Persistence"]
  node_network["Networking"]
  node_audio["Audio"]
  node_secrets["Secret decryption"]
end

subgraph group_desktop["Desktop features"]
  node_river["River desktop"]
  node_waybar["Waybar status bar"]
  node_wob["Wob OSD"]
  node_kanshi["Kanshi displays"]
  node_fuzzel["Fuzzel launcher"]
  node_kitty["Kitty terminal"]
  node_tmux["Tmux sessions"]
  node_zsh["Zsh shell"]
  node_nvim["Neovim editor"]
  node_keepass["KeePassXC"]
end

subgraph group_profiles["Optional profiles"]
  node_dev["Development profile"]
  node_infra["Infrastructure profile"]
  node_security["Security profile"]
  node_ai["AI profile"]
  node_gaming["Gaming profile"]
end

node_operator(("System operator"))
node_secretsrepo[("Encrypted secrets repo")]
node_key["YubiKey or SSH key"]

node_secretsrepo -->|"provides encrypted data"| node_secrets
node_key -->|"unlocks secrets"| node_secrets
node_hostcfg -.->|"may enable profile"| node_dev
node_hostcfg -.->|"may enable profile"| node_infra
node_hostcfg -.->|"may enable profile"| node_security

click node_hostcfg "https://github.com/orysse/config/tree/main/modules/hosts/thinkpad"
click node_flakeparts "https://github.com/orysse/config/blob/main/modules/parts.nix"
click node_boot "https://github.com/orysse/config/blob/main/modules/system/core/boot.nix"
click node_core "https://github.com/orysse/config/tree/main/modules/system/core"
click node_disk "https://github.com/orysse/config/blob/main/modules/hosts/thinkpad/_disko.nix"
click node_persistence "https://github.com/orysse/config/tree/main/modules/system/impermanence"
click node_network "https://github.com/orysse/config/tree/main/modules/system/network"
click node_audio "https://github.com/orysse/config/tree/main/modules/system/audio"
click node_secrets "https://github.com/orysse/config/tree/main/modules/flavors/secrets"
click node_river "https://github.com/orysse/config/tree/main/modules/features/river"
click node_waybar "https://github.com/orysse/config/tree/main/modules/features/waybar"
click node_wob "https://github.com/orysse/config/tree/main/modules/features/wob"
click node_kanshi "https://github.com/orysse/config/tree/main/modules/features/kanshi"
click node_fuzzel "https://github.com/orysse/config/tree/main/modules/features/fuzzel"
click node_kitty "https://github.com/orysse/config/tree/main/modules/features/kitty"
click node_tmux "https://github.com/orysse/config/tree/main/modules/features/tmux"
click node_zsh "https://github.com/orysse/config/tree/main/modules/features/zsh"
click node_nvim "https://github.com/orysse/config/tree/main/modules/features/nvim"
click node_keepass "https://github.com/orysse/config/tree/main/modules/features/keepassxc"
click node_dev "https://github.com/orysse/config/tree/main/modules/flavors/dev"
click node_infra "https://github.com/orysse/config/tree/main/modules/flavors/infra"
click node_security "https://github.com/orysse/config/tree/main/modules/flavors/security"
click node_ai "https://github.com/orysse/config/tree/main/modules/flavors/ai"
click node_gaming "https://github.com/orysse/config/tree/main/modules/flavors/gaming"

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_hostcfg,node_flakeparts toneBlue
class node_boot,node_core,node_disk,node_persistence,node_network,node_audio,node_secrets,node_secretsrepo toneAmber
class node_river,node_waybar,node_wob,node_kanshi,node_fuzzel,node_kitty,node_tmux,node_zsh,node_nvim,node_keepass toneMint
class node_dev,node_infra,node_security,node_ai,node_gaming toneRose
class node_operator,node_key toneIndigo
```

## Components

### Host configuration

- [ThinkPad host](https://github.com/orysse/config/tree/main/modules/hosts/thinkpad): `modules/hosts/thinkpad`
- [Flake parts](https://github.com/orysse/config/blob/main/modules/parts.nix): `modules/parts.nix`

### System foundation

- [Boot configuration](https://github.com/orysse/config/blob/main/modules/system/core/boot.nix): `modules/system/core/boot.nix`
- [Core system](https://github.com/orysse/config/tree/main/modules/system/core): `modules/system/core`
- [Disk layout](https://github.com/orysse/config/blob/main/modules/hosts/thinkpad/_disko.nix): `modules/hosts/thinkpad/_disko.nix`
- [Persistence](https://github.com/orysse/config/tree/main/modules/system/impermanence): `modules/system/impermanence`
- [Networking](https://github.com/orysse/config/tree/main/modules/system/network): `modules/system/network`
- [Audio](https://github.com/orysse/config/tree/main/modules/system/audio): `modules/system/audio`
- [Secret decryption](https://github.com/orysse/config/tree/main/modules/flavors/secrets): `modules/flavors/secrets`

### Desktop features

- [River desktop](https://github.com/orysse/config/tree/main/modules/features/river): `modules/features/river`
- [Waybar status bar](https://github.com/orysse/config/tree/main/modules/features/waybar): `modules/features/waybar`
- [Wob OSD](https://github.com/orysse/config/tree/main/modules/features/wob): `modules/features/wob`
- [Kanshi displays](https://github.com/orysse/config/tree/main/modules/features/kanshi): `modules/features/kanshi`
- [Fuzzel launcher](https://github.com/orysse/config/tree/main/modules/features/fuzzel): `modules/features/fuzzel`
- [Kitty terminal](https://github.com/orysse/config/tree/main/modules/features/kitty): `modules/features/kitty`
- [Tmux sessions](https://github.com/orysse/config/tree/main/modules/features/tmux): `modules/features/tmux`
- [Zsh shell](https://github.com/orysse/config/tree/main/modules/features/zsh): `modules/features/zsh`
- [Neovim editor](https://github.com/orysse/config/tree/main/modules/features/nvim): `modules/features/nvim`
- [KeePassXC](https://github.com/orysse/config/tree/main/modules/features/keepassxc): `modules/features/keepassxc`

### Optional profiles

- [Development profile](https://github.com/orysse/config/tree/main/modules/flavors/dev): `modules/flavors/dev`
- [Infrastructure profile](https://github.com/orysse/config/tree/main/modules/flavors/infra): `modules/flavors/infra`
- [Security profile](https://github.com/orysse/config/tree/main/modules/flavors/security): `modules/flavors/security`
- [AI profile](https://github.com/orysse/config/tree/main/modules/flavors/ai): `modules/flavors/ai`
- [Gaming profile](https://github.com/orysse/config/tree/main/modules/flavors/gaming): `modules/flavors/gaming`

### Other components

- **System operator**
- **Encrypted secrets repo**
- **YubiKey or SSH key**

## Connections

- Encrypted secrets repo → Secret decryption: provides encrypted data (evidence: `README.md`)
- YubiKey or SSH key → Secret decryption: unlocks secrets (evidence: `README.md`)
- ThinkPad host → Development profile: may enable profile (evidence: `README.md`)
- ThinkPad host → Infrastructure profile: may enable profile (evidence: `README.md`)
- ThinkPad host → Security profile: may enable profile (evidence: `README.md`)
