# sudosubin/nixos-config architecture

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

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

## Overview

##### Detailed Component Breakdown

**System Targets**
- Darwin Configuration
- System Settings
- Darwin-specific Programs
- Linux Configuration
- Hardware Configuration
- Linux-specific Programs

**Shared Components**
- Home Manager
- Program Configurations
- System-specific Overrides
- NixPkgs
- Custom Package Definitions

**Program Categories**
- Shell Tools (tmux, direnv, etc.)
- Development Tools (python, rust, go, etc.)
- Applications (VSCode, WezTerm, etc.)

##### Implementation Details

- Configuration inheritance patterns
- Module organization
- Package override mechanisms
- System-specific customizations

##### Additional Notes

- Relationship between flake.nix and the component hierarchy
- Where custom scripts (like auto-update-modules.py) fit in
- Separation between shared and system-specific configurations

Key Architectural Patterns to Emphasize:
##### Development environment integration

Remember to include external dependencies like:
- Home Manager
- Nixpkgs
- System-specific package managers
- Third-party applications

This will create a comprehensive view of how the different components interact while maintaining clarity about the system's architecture.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Styles and Classes
    classDef darwin fill:#ffdddd,stroke:#333
    classDef linux fill:#ddddff,stroke:#333
    classDef shared fill:#ddffdd,stroke:#333
    classDef external fill:#eeeeee,stroke:#333
    classDef config fill:#ffffdd,stroke:#333

    %% Legend
    subgraph Legend
        L1[Darwin Components]:::darwin
        L2[Linux Components]:::linux
        L3[Shared Components]:::shared
        L4[External Dependencies]:::external
        L5[Configuration Files]:::config
    end

    %% System Targets Layer
    subgraph "System Targets"
        Darwin["Darwin Configuration"]:::darwin
        Linux["Linux Configuration"]:::linux
        DevShell["Dev Shell Configuration"]:::shared
    end

    %% Core Components Layer
    subgraph "Core Components"
        SharedModules["Shared Modules"]:::shared
        HomeManager["Home Manager"]:::external
        NixPkgs["NixPkgs Libraries"]:::external
    end

    %% Program Categories Layer
    subgraph "Program Categories"
        direction TB
        SystemProgs["System Programs"]:::shared
        DevTools["Development Tools"]:::shared
        UserApps["User Applications"]:::shared
    end

    %% Platform-Specific Components
    subgraph "Darwin-Specific"
        DarwinProgs["Darwin Programs"]:::darwin
        DarwinSettings["System Settings"]:::darwin
    end

    subgraph "Linux-Specific"
        LinuxProgs["Linux Programs"]:::linux
        HardwareConfig["Hardware Configuration"]:::linux
    end

    %% Configuration Management
    Flake["flake.nix"]:::config
    AutoUpdate["auto-update-modules.py"]:::config

    %% Relationships
    Flake --> Darwin
    Flake --> Linux
    Flake --> DevShell
    
    Darwin --> DarwinProgs
    Darwin --> DarwinSettings
    Linux --> LinuxProgs
    Linux --> HardwareConfig
    
    SharedModules --> SystemProgs
    SharedModules --> DevTools
    SharedModules --> UserApps
    
    HomeManager --> Darwin
    HomeManager --> Linux
    
    NixPkgs --> HomeManager
    
    AutoUpdate --> SharedModules

    %% Click Events
    click Darwin "https://github.com/sudosubin/nixos-config/blob/main/modules/darwin/configuration.nix"
    click Linux "https://github.com/sudosubin/nixos-config/blob/main/modules/linux/configuration.nix"
    click DevShell "https://github.com/sudosubin/nixos-config/blob/main/libraries/dev-shell/default.nix"
    click SharedModules "https://github.com/sudosubin/nixos-config/tree/main/modules/shared"
    click HomeManager "https://github.com/sudosubin/nixos-config/tree/main/libraries/home-manager"
    click NixPkgs "https://github.com/sudosubin/nixos-config/tree/main/libraries/nixpkgs"
    click DevTools "https://github.com/sudosubin/nixos-config/tree/main/modules/shared/programs"
    click SystemProgs "https://github.com/sudosubin/nixos-config/tree/main/modules/shared/programs"
    click UserApps "https://github.com/sudosubin/nixos-config/tree/main/modules/shared/programs"
    click DarwinProgs "https://github.com/sudosubin/nixos-config/tree/main/modules/darwin/programs"
    click LinuxProgs "https://github.com/sudosubin/nixos-config/tree/main/modules/linux/programs"
    click Flake "https://github.com/sudosubin/nixos-config/blob/main/flake.nix"
    click AutoUpdate "https://github.com/sudosubin/nixos-config/blob/main/scripts/auto-update-modules.py"
```
