# siraben/dotfiles architecture

> Architecture diagram of the GitHub repository siraben/dotfiles, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2024-12-28). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/siraben/dotfiles
- Repository: https://github.com/siraben/dotfiles

## Overview

##### Main Components

a. Configuration Management Layer
- Home Manager (central orchestrator)
- Nix Package Manager (package management)
- Stow (symlink farm manager)

b. Operating System Layer
- NixOS Configuration
- macOS Configuration
- Shared Configuration

c. Application Configuration Modules
- Editor (Emacs) Configuration
- Window Managers (i3, GNOME, Sway)
- Terminal Emulators (Alacritty, Kitty)
- Shell Environment
- Custom Package Sets

##### Specific Elements

a. Package Management Section:
- Nix package manager with connections to custom package sets
- Home Manager configuration flow
- Custom overlay system

b. Configuration Modules:
- Emacs configuration with its modules structure
- Window manager configurations (i3, Sway, GNOME)
- Terminal emulator configurations
- Development environment setups

c. OS-Specific Components:
- NixOS-specific configurations
- macOS-specific configurations
- Shared configurations

##### Important Details to Highlight

a. Custom Package Sets:
- LaTeX packages
- Haskell packages
- Python packages
- How they integrate with the main system

b. Emacs Configuration:
- Modular structure
- Custom build process via GitHub Actions
- Language-specific module organization

##### Implementation Notes

- Version information for critical components
- External dependencies and requirements
- GitHub Actions workflow integration

- Application Layer     |
- (Emacs, WM, Terminal)|

- Configuration Layer   |
- (Home Manager, Stow) |

- Package Management   |
- (Nix, Custom Sets)   |

- Operating System     |
- (NixOS, macOS)      |

## Diagram (Mermaid)

```mermaid
graph TB
    %% Define styles
    classDef os fill:#b3d1ff,stroke:#333
    classDef config fill:#90EE90,stroke:#333
    classDef app fill:#FFB366,stroke:#333
    classDef pkg fill:#DDA0DD,stroke:#333
    classDef server fill:#FFB6C1,stroke:#333

    %% Operating System Layer
    subgraph OS
        NixOS["NixOS"]
        MacOS["macOS"]
        SharedOS["Shared OS Config"]
    end
    class NixOS,MacOS,SharedOS os

    %% Package Management Layer
    subgraph PackageManagement
        NixPkg["Nix Package Manager"]
        HomeManager["Home Manager"]
        Stow["Stow"]
        
        CustomPkgs["Custom Package Sets"]
        HaskellPkgs["Haskell Packages"]
        PythonPkgs["Python Packages"]
        TeXPkgs["LaTeX Packages"]
    end
    class NixPkg,HomeManager,Stow config
    class CustomPkgs,HaskellPkgs,PythonPkgs,TeXPkgs pkg

    %% Application Configuration Layer
    subgraph AppConfig
        EmacsConfig["Emacs Configuration"]
        WMConfig["Window Managers"]
        TermConfig["Terminal Emulators"]
        
        I3["i3"]
        Sway["Sway"]
        GNOME["GNOME"]
        
        Alacritty["Alacritty"]
        Kitty["Kitty"]
        
        EmacsCore["Emacs Core"]
        EmacsMods["Emacs Modules"]
        EmacsOSMods["OS-Specific Modules"]
    end
    class EmacsConfig,WMConfig,TermConfig,I3,Sway,GNOME,Alacritty,Kitty,EmacsCore,EmacsMods,EmacsOSMods app

    %% Server Configuration Layer
    subgraph ServerConfig
        ServerCore["Server Core"]
        Nginx["Nginx"]
        Nextcloud["Nextcloud"]
        Mailserver["Mail Server"]
    end
    class ServerCore,Nginx,Nextcloud,Mailserver server

    %% Relationships
    NixOS & MacOS --> SharedOS
    SharedOS --> HomeManager
    NixPkg --> HomeManager
    HomeManager --> CustomPkgs
    CustomPkgs --> HaskellPkgs & PythonPkgs & TeXPkgs
    
    HomeManager --> EmacsConfig & WMConfig & TermConfig
    WMConfig --> I3 & Sway & GNOME
    TermConfig --> Alacritty & Kitty
    
    EmacsConfig --> EmacsCore
    EmacsCore --> EmacsMods
    EmacsMods --> EmacsOSMods
    
    HomeManager --> ServerConfig
    ServerCore --> Nginx & Nextcloud & Mailserver

    %% Click events for component mapping
    click HomeManager "https://github.com/siraben/dotfiles/blob/master/home-manager/.config/nixpkgs/home.nix"
    click NixOS "https://github.com/siraben/dotfiles/blob/master/nixos/configuration.nix"
    click CustomPkgs "https://github.com/siraben/dotfiles/blob/master/home-manager/.config/nixpkgs/packages.nix"
    click HaskellPkgs "https://github.com/siraben/dotfiles/blob/master/home-manager/.config/nixpkgs/haskell-packages.nix"
    click PythonPkgs "https://github.com/siraben/dotfiles/blob/master/home-manager/.config/nixpkgs/python-packages.nix"
    click TeXPkgs "https://github.com/siraben/dotfiles/blob/master/home-manager/.config/nixpkgs/texlive-packages.nix"
    click I3 "https://github.com/siraben/dotfiles/tree/master/i3/.config/i3/config"
    click Sway "https://github.com/siraben/dotfiles/tree/master/sway/.config/sway/config"
    click Alacritty "https://github.com/siraben/dotfiles/blob/master/alacritty/.config/alacritty/alacritty.yml"
    click Kitty "https://github.com/siraben/dotfiles/blob/master/kitty/.config/kitty/kitty.conf"
    click EmacsCore "https://github.com/siraben/dotfiles/blob/master/emacs/.emacs.d/init.el"
    click EmacsMods "https://github.com/siraben/dotfiles/tree/master/emacs/.emacs.d/modules/"
    click NixPkg "https://github.com/siraben/dotfiles/blob/master/home-manager/.config/nix/nix.conf"
    click ServerCore "https://github.com/siraben/dotfiles/blob/master/server/configuration.nix"
    click Nginx "https://github.com/siraben/dotfiles/blob/master/server/nginx.nix"
    click Nextcloud "https://github.com/siraben/dotfiles/blob/master/server/nextcloud.nix"
    click Mailserver "https://github.com/siraben/dotfiles/blob/master/server/mailserver.nix"
```
