# srid/nixos-config architecture

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

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

## Overview

##### Main Components Structure

**┌─ Configuration Layer ─────────────────────┐**
- ./configurations/                         │
- darwin/   (macOS configs)             │
- nixos/    (NixOS configs)             │
- home/     (Home-manager configs)       │
- ┤
- Module Layer                             │
- ./modules/                               │
- darwin/   (Darwin-specific modules)   │
- nixos/    (NixOS-specific modules)    │
- home/     (Home-manager modules)      │
- flake-parts/ (Flake module system)    │
- ┤
- Infrastructure Layer                     │
- overlays/  (Nixpkgs modifications)    │
- packages/  (Custom packages)          │
- secrets/   (Agenix-managed secrets)   │
- ┘

##### Component Relationships

**┌─ System Configurations ─────┐**
- NixOS                   │
- Desktop/Laptop       │
- Server              │
- Darwin (macOS)         │
- ┘

**┌─ Feature Modules ──────────┐**
- GUI (Hyprland/KDE)     │
- Development Tools      │
- System Services       │
- Security             │
- ┘

##### Important Elements to Highlight

- flake.nix as the entry point
- flake-parts module system
- Configuration inheritance patterns
- Secret management with agenix
- System-specific customizations
- Home-manager integration

##### Integration Points

Clear integration points for:
- NixOS system configuration
- Darwin system configuration
- Home-manager user configuration
- Overlay system
- Secret management
- Custom package definitions

##### Deployment Flow

A separate section showing the deployment flow:
**Source Code → Flake Build → System Generation → Deployment**

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph Entry
        Flake["flake.nix"]:::entry
        Config["config.nix"]:::entry
    end

    subgraph "Configuration Layer"
        DarwinConfig["Darwin Configs"]:::config
        NixOSConfig["NixOS Configs"]:::config
        HomeConfig["Home Configs"]:::config
    end

    subgraph "Module Layer"
        DarwinMod["Darwin Modules"]:::module
        NixOSMod["NixOS Modules"]:::module
        HomeMod["Home-manager Modules"]:::module
        FlakeMod["Flake-parts Modules"]:::module
    end

    subgraph "Infrastructure Layer"
        Overlays["Overlays"]:::infra
        Packages["Packages"]:::infra
        Secrets["Secrets Management"]:::security
    end

    subgraph "System-specific Configurations"
        Server["Server Components"]:::system
        Desktop["Desktop Features"]:::system
        DarwinSys["Darwin System"]:::system
    end

    subgraph "Feature Modules"
        direction TB
        GUI["GUI Components"]:::feature
        DevTools["Development Tools"]:::feature
        SysServices["System Services"]:::feature
        Security["Security Components"]:::security
    end

    subgraph "GUI Components"
        Hyprland["Hyprland"]:::gui
        KDE["KDE"]:::gui
    end

    subgraph "Development Environment"
        VSCode["VSCode"]:::dev
        Neovim["Neovim"]:::dev
        Git["Git"]:::dev
    end

    subgraph "Terminal"
        Kitty["Kitty"]:::term
        WezTerm["WezTerm"]:::term
        Zsh["Zsh"]:::term
    end

    subgraph "Services"
        PostgreSQL["PostgreSQL"]:::service
        Docker["Docker"]:::service
        Email["Email"]:::service
    end

    %% Relationships
    Flake --> Config
    Config --> DarwinConfig & NixOSConfig & HomeConfig
    DarwinConfig --> DarwinMod
    NixOSConfig --> NixOSMod
    HomeConfig --> HomeMod
    FlakeMod --> DarwinMod & NixOSMod & HomeMod
    
    DarwinMod --> DarwinSys
    NixOSMod --> Server & Desktop
    HomeMod --> DevTools
    
    Desktop --> GUI
    GUI --> Hyprland & KDE
    DevTools --> VSCode & Neovim & Git
    SysServices --> PostgreSQL & Docker & Email
    
    %% Infrastructure connections
    Overlays -.-> DarwinMod & NixOSMod
    Packages -.-> DarwinMod & NixOSMod
    Secrets -.-> Security
    
    %% Click events
    click DarwinConfig "https://github.com/srid/nixos-config/tree/master//configurations/darwin/"
    click NixOSConfig "https://github.com/srid/nixos-config/tree/master//configurations/nixos/"
    click HomeConfig "https://github.com/srid/nixos-config/tree/master//modules/home/"
    click DarwinMod "https://github.com/srid/nixos-config/tree/master//modules/darwin/"
    click NixOSMod "https://github.com/srid/nixos-config/tree/master//modules/nixos/"
    click HomeMod "https://github.com/srid/nixos-config/tree/master//modules/home/"
    click FlakeMod "https://github.com/srid/nixos-config/tree/master//modules/flake-parts/"
    click Overlays "https://github.com/srid/nixos-config/tree/master//overlays/"
    click Packages "https://github.com/srid/nixos-config/tree/master//packages/"
    click Secrets "https://github.com/srid/nixos-config/tree/master//secrets/"
    click Hyprland "https://github.com/srid/nixos-config/tree/master//modules/nixos/linux/gui/hyprland/"
    click KDE "https://github.com/srid/nixos-config/blob/master//modules/nixos/linux/gui/kde.nix"
    click Desktop "https://github.com/srid/nixos-config/tree/master//modules/nixos/linux/gui/desktopish/"
    click Server "https://github.com/srid/nixos-config/tree/master//modules/nixos/linux/server/"
    click DarwinSys "https://github.com/srid/nixos-config/tree/master//modules/darwin/all/"
    click VSCode "https://github.com/srid/nixos-config/blob/master//modules/nixos/linux/gui/desktopish/vscode.nix"
    click Neovim "https://github.com/srid/nixos-config/tree/master//modules/home/all/neovim/"
    click Git "https://github.com/srid/nixos-config/blob/master//modules/home/all/git.nix"
    click Security "https://github.com/srid/nixos-config/tree/master//modules/nixos/linux/server/harden/"
    click Secrets "https://github.com/srid/nixos-config/blob/master//secrets/secrets.nix"
    click Flake "https://github.com/srid/nixos-config/blob/master//flake.nix"
    click Config "https://github.com/srid/nixos-config/blob/master//config.nix"
    click Kitty "https://github.com/srid/nixos-config/blob/master//modules/home/all/kitty.nix"
    click WezTerm "https://github.com/srid/nixos-config/tree/master//modules/home/all/wezterm/"
    click Zsh "https://github.com/srid/nixos-config/blob/master//modules/home/all/zsh.nix"
    click PostgreSQL "https://github.com/srid/nixos-config/blob/master//modules/nixos/linux/postgres.nix"
    click Docker "https://github.com/srid/nixos-config/blob/master//modules/nixos/linux/docker.nix"
    click Email "https://github.com/srid/nixos-config/tree/master//modules/nixos/linux/email/"

    %% Styling
    classDef entry fill:#6C8EBF,stroke:#333,stroke-width:2px
    classDef config fill:#9BC2E6,stroke:#333
    classDef module fill:#A8D08D,stroke:#333
    classDef infra fill:#FFB366,stroke:#333
    classDef system fill:#B4A7D6,stroke:#333
    classDef feature fill:#D5A6BD,stroke:#333
    classDef security fill:#FF9999,stroke:#333
    classDef gui fill:#C3B4F3,stroke:#333
    classDef dev fill:#A2C4C9,stroke:#333
    classDef term fill:#D5E8D4,stroke:#333
    classDef service fill:#FFE599,stroke:#333
```
