# dustinlyons/nixos-config architecture

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

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

## Overview

This repository is a personal, reusable Nix configuration for building declarative macOS and NixOS development environments. Users initialize or edit host and module configuration, then build or apply it through platform-specific app commands. The graph also captures documented capabilities such as shared Home Manager setup, secrets, overlays, disk management, and managed desktop configuration. Source evidence is limited to the README and two sampled Python utilities; edges between Nix subsystems are included only where the README documents their relationship.

Main entry points: [`modules/nixos/wow-chat-watch/wow_chat_watch.py`](https://github.com/dustinlyons/nixos-config/blob/main/modules/nixos/wow-chat-watch/wow_chat_watch.py) (WoW chat watcher), [`flake.nix`](https://github.com/dustinlyons/nixos-config/blob/main/flake.nix) (Flake entry), [`modules/darwin`](https://github.com/dustinlyons/nixos-config/tree/main/modules/darwin) (macOS modules), [`modules/nixos`](https://github.com/dustinlyons/nixos-config/tree/main/modules/nixos) (NixOS modules)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_bootstrap["Bootstrap and hosts"]
  node_platform_apps["Platform commands"]
  node_flake["Flake entry<br/>[flake.nix]"]
  node_host_configs["Host definitions"]
end

subgraph group_config["Platform configuration"]
  node_macos_modules["macOS modules"]
  node_nixos_modules["NixOS modules"]
  node_secrets["Secrets management<br/>[secrets.nix]"]
  node_disk["Disk management"]
  node_overlays["Package overlays"]
end

subgraph group_shared["Shared environment"]
  node_shared_modules["Shared modules"]
  node_home_manager["Home Manager<br/>[home-manager.nix]"]
  node_emacs["Emacs configuration<br/>[config.org]"]
end

subgraph group_utilities["Home utilities"]
  node_garage_analysis["Garage image analysis<br/>[analyze_garage.py]"]
  node_garage_state["Analysis results"]
  node_wow_watcher["WoW chat watcher<br/>[wow_chat_watch.py]"]
  node_chat_log["WoW chat log"]
  node_chat_rules["Alert rules<br/>[rules.toml]"]
  node_match_history["Match history"]
end

node_user(("Configuration user"))
node_desktop_notify["Desktop notifications"]
node_nix_runtime["Nix system"]

node_user -->|"runs commands"| node_platform_apps
node_platform_apps -->|"builds or applies"| node_flake
node_flake -.->|"configures hosts"| node_host_configs
node_host_configs -.->|"selects modules"| node_macos_modules
node_host_configs -.->|"selects modules"| node_nixos_modules
node_macos_modules -->|"shares configuration"| node_shared_modules
node_nixos_modules -->|"shares configuration"| node_shared_modules
node_macos_modules -->|"uses Home Manager"| node_home_manager
node_nixos_modules -->|"uses Home Manager"| node_home_manager
node_macos_modules -.->|"configures secrets"| node_secrets
node_nixos_modules -->|"declares disks"| node_disk
node_flake -->|"loads overlays"| node_overlays
node_shared_modules -->|"configures Emacs"| node_emacs
node_flake -->|"builds environment"| node_nix_runtime
node_user -.->|"submits snapshot"| node_garage_analysis
node_garage_analysis -->|"writes analysis"| node_garage_state
node_user -.->|"runs watcher"| node_wow_watcher
node_wow_watcher -->|"follows log"| node_chat_log
node_wow_watcher -->|"loads rules"| node_chat_rules
node_wow_watcher -->|"appends matches"| node_match_history
node_wow_watcher -->|"sends alerts"| node_desktop_notify

click node_platform_apps "https://github.com/dustinlyons/nixos-config/tree/main/apps"
click node_flake "https://github.com/dustinlyons/nixos-config/blob/main/flake.nix"
click node_host_configs "https://github.com/dustinlyons/nixos-config/tree/main/hosts"
click node_macos_modules "https://github.com/dustinlyons/nixos-config/tree/main/modules/darwin"
click node_nixos_modules "https://github.com/dustinlyons/nixos-config/tree/main/modules/nixos"
click node_secrets "https://github.com/dustinlyons/nixos-config/blob/main/modules/darwin/secrets.nix"
click node_disk "https://github.com/dustinlyons/nixos-config/tree/main/modules/nixos"
click node_overlays "https://github.com/dustinlyons/nixos-config/tree/main/overlays"
click node_shared_modules "https://github.com/dustinlyons/nixos-config/tree/main/modules/shared"
click node_home_manager "https://github.com/dustinlyons/nixos-config/blob/main/modules/shared/home-manager.nix"
click node_emacs "https://github.com/dustinlyons/nixos-config/blob/main/modules/shared/config/emacs/config.org"
click node_garage_analysis "https://github.com/dustinlyons/nixos-config/blob/main/modules/nixos/scripts/analyze_garage.py"
click node_wow_watcher "https://github.com/dustinlyons/nixos-config/blob/main/modules/nixos/wow-chat-watch/wow_chat_watch.py"
click node_chat_rules "https://github.com/dustinlyons/nixos-config/blob/main/modules/nixos/wow-chat-watch/rules.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_platform_apps,node_flake,node_host_configs,node_user toneBlue
class node_macos_modules,node_nixos_modules,node_secrets,node_disk,node_overlays toneAmber
class node_shared_modules,node_home_manager,node_emacs toneMint
class node_garage_analysis,node_garage_state,node_wow_watcher,node_chat_log,node_chat_rules,node_match_history toneRose
class node_desktop_notify,node_nix_runtime toneIndigo
```

## Components

### Bootstrap and hosts

- [Platform commands](https://github.com/dustinlyons/nixos-config/tree/main/apps): `apps`
- [Flake entry](https://github.com/dustinlyons/nixos-config/blob/main/flake.nix): `flake.nix`
- [Host definitions](https://github.com/dustinlyons/nixos-config/tree/main/hosts): `hosts`

### Platform configuration

- [macOS modules](https://github.com/dustinlyons/nixos-config/tree/main/modules/darwin): `modules/darwin`
- [NixOS modules](https://github.com/dustinlyons/nixos-config/tree/main/modules/nixos): `modules/nixos`
- [Secrets management](https://github.com/dustinlyons/nixos-config/blob/main/modules/darwin/secrets.nix): `modules/darwin/secrets.nix`
- [Disk management](https://github.com/dustinlyons/nixos-config/tree/main/modules/nixos): `modules/nixos`
- [Package overlays](https://github.com/dustinlyons/nixos-config/tree/main/overlays): `overlays`

### Shared environment

- [Shared modules](https://github.com/dustinlyons/nixos-config/tree/main/modules/shared): `modules/shared`
- [Home Manager](https://github.com/dustinlyons/nixos-config/blob/main/modules/shared/home-manager.nix): `modules/shared/home-manager.nix`
- [Emacs configuration](https://github.com/dustinlyons/nixos-config/blob/main/modules/shared/config/emacs/config.org): `modules/shared/config/emacs/config.org`

### Home utilities

- [Garage image analysis](https://github.com/dustinlyons/nixos-config/blob/main/modules/nixos/scripts/analyze_garage.py): `modules/nixos/scripts/analyze_garage.py`
- **Analysis results**
- [WoW chat watcher](https://github.com/dustinlyons/nixos-config/blob/main/modules/nixos/wow-chat-watch/wow_chat_watch.py): `modules/nixos/wow-chat-watch/wow_chat_watch.py`
- **WoW chat log**
- [Alert rules](https://github.com/dustinlyons/nixos-config/blob/main/modules/nixos/wow-chat-watch/rules.toml): `modules/nixos/wow-chat-watch/rules.toml`
- **Match history**

### Other components

- **Configuration user**
- **Desktop notifications**
- **Nix system**

## Connections

- Configuration user → Platform commands: runs commands (evidence: `README.md`)
- Platform commands → Flake entry: builds or applies (evidence: `README.md`)
- Flake entry → Host definitions: configures hosts
- Host definitions → macOS modules: selects modules
- Host definitions → NixOS modules: selects modules
- macOS modules → Shared modules: shares configuration (evidence: `README.md`)
- NixOS modules → Shared modules: shares configuration (evidence: `README.md`)
- macOS modules → Home Manager: uses Home Manager (evidence: `README.md`)
- NixOS modules → Home Manager: uses Home Manager (evidence: `README.md`)
- macOS modules → Secrets management: configures secrets
- NixOS modules → Disk management: declares disks (evidence: `README.md`)
- Flake entry → Package overlays: loads overlays (evidence: `README.md`)
- Shared modules → Emacs configuration: configures Emacs (evidence: `README.md`)
- Flake entry → Nix system: builds environment (evidence: `README.md`)
- Configuration user → Garage image analysis: submits snapshot
- Garage image analysis → Analysis results: writes analysis (evidence: `modules/nixos/scripts/analyze_garage.py`)
- Configuration user → WoW chat watcher: runs watcher
- WoW chat watcher → WoW chat log: follows log (evidence: `modules/nixos/wow-chat-watch/wow_chat_watch.py`)
- WoW chat watcher → Alert rules: loads rules (evidence: `modules/nixos/wow-chat-watch/wow_chat_watch.py`)
- WoW chat watcher → Match history: appends matches (evidence: `modules/nixos/wow-chat-watch/wow_chat_watch.py`)
- WoW chat watcher → Desktop notifications: sends alerts (evidence: `modules/nixos/wow-chat-watch/wow_chat_watch.py`)
