# divyaranjan1905/dotfiles architecture

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

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

## Overview

##### Main Components

a. Core System Configuration Layer
- GNU Guix System Configuration
- GNU Guix Home Configuration
- System Services and Daemons

b. Window Manager Layer
- StumpWM (primary window manager)
- StumpWM Modules (organized by categories)
- Media controls
- Modeline components
- Utility modules
- Minor mode modules

c. Application Configuration Layer
- Emacs Configuration
- Terminal Emulators (Alacritty, ST)
- Shell Configurations (Bash, ZSH)
- X11 Configuration

d. Utility Layer
- Scripts
- Audio Configuration
- Suckless Tools (dmenu, st)

**┌─────────────────────────────────────────┐**
- User Interface               │
- ┤
- StumpWM (Window Manager)                │
- ┬───────────┬────────────┤
- Media Modules │ Modeline  │ Utilities  │
- ┴───────────┴────────────┤
- Application Configurations       │
- ┤
- GNU Guix Configuration          │
- ┤
- System Services              │
- ┘

##### Key Relationships

- Connections between X11 configuration and window manager
- Links between shell configurations and user environment

##### Implementation Details

- Use standardized symbols for different types of components
- Version information for key components
- Configuration file paths for main components

##### Documentation Notes

- Annotations for important configuration files
- Brief descriptions of key components
- Reference relevant documentation sources
- System requirements and dependencies

- The central role of GNU Guix in system management
- The extensive StumpWM configuration and module system
- The integration with Emacs as a key application
- The custom scripts and utilities that tie the system together

Remember to maintain a balance between detail and clarity, focusing on the architectural relationships while avoiding excessive implementation details.

## Diagram (Mermaid)

```mermaid
graph TB
    %% Styles
    classDef system fill:#a8d1f0,stroke:#333
    classDef wm fill:#90EE90,stroke:#333
    classDef app fill:#FFB347,stroke:#333
    classDef util fill:#DDA0DD,stroke:#333
    classDef module fill:#98FB98,stroke:#333

    %% Core System Layer
    subgraph System
        GuixSystem["GNU Guix System"]:::system
        GuixHome["GNU Guix Home"]:::system
        GuixChannels["Guix Channels"]:::system
        SystemServices["System Services"]:::system
    end

    %% Window Manager Layer
    subgraph WindowManager
        StumpWM["StumpWM Core"]:::wm
        
        subgraph Modules
            MediaMod["Media Controls"]:::module
            ModelineMod["Modeline Components"]:::module
            UtilMod["Utility Modules"]:::module
            MinorMod["Minor Mode Modules"]:::module
        end
    end

    %% Application Layer
    subgraph Apps
        Emacs["Emacs"]:::app
        Terminal["Terminal Emulators"]:::app
        ShellConfig["Shell Configurations"]:::app
        X11Config["X11 Configuration"]:::app
    end

    %% Utility Layer
    subgraph Utils
        Scripts["Scripts"]:::util
        AudioConfig["Audio Configuration"]:::util
        SucklessTools["Suckless Tools"]:::util
        ShellEnv["Shell Environment"]:::util
    end

    %% Relationships
    GuixSystem --> GuixHome
    GuixSystem --> SystemServices
    GuixChannels --> GuixSystem
    
    StumpWM --> MediaMod
    StumpWM --> ModelineMod
    StumpWM --> UtilMod
    StumpWM --> MinorMod
    
    GuixHome --> Apps
    GuixHome --> Utils
    
    X11Config --> StumpWM
    ShellConfig --> ShellEnv
    Terminal --> ShellConfig

    %% Click Events
    click GuixSystem "https://github.com/divyaranjan1905/dotfiles/blob/master/.config/guix/system.scm"
    click GuixHome "https://github.com/divyaranjan1905/dotfiles/blob/master/.config/guix/home-divya.scm"
    click GuixChannels "https://github.com/divyaranjan1905/dotfiles/blob/master/.config/guix/channels.scm"
    click StumpWM "https://github.com/divyaranjan1905/dotfiles/blob/master/.stumpwm.d/init.lisp"
    click MediaMod "https://github.com/divyaranjan1905/dotfiles/tree/master/.stumpwm.d/modules/media"
    click ModelineMod "https://github.com/divyaranjan1905/dotfiles/tree/master/.stumpwm.d/modules/modeline"
    click UtilMod "https://github.com/divyaranjan1905/dotfiles/tree/master/.stumpwm.d/modules/util"
    click MinorMod "https://github.com/divyaranjan1905/dotfiles/tree/master/.stumpwm.d/modules/minor-mode"
    click Emacs "https://github.com/divyaranjan1905/dotfiles/blob/master/.emacs.d/init.el"
    click Terminal "https://github.com/divyaranjan1905/dotfiles/blob/master/.config/alacritty/alacritty.toml"
    click ShellConfig "https://github.com/divyaranjan1905/dotfiles/blob/master/bash/.bashrc"
    click X11Config "https://github.com/divyaranjan1905/dotfiles/blob/master/x/.xinitrc"
    click Scripts "https://github.com/divyaranjan1905/dotfiles/tree/master/scripts"
    click AudioConfig "https://github.com/divyaranjan1905/dotfiles/blob/master/alsa/.asoundrc"
    click SucklessTools "https://github.com/divyaranjan1905/dotfiles/tree/master/suckless/dmenu-flexipatch"
    click ShellEnv "https://github.com/divyaranjan1905/dotfiles/tree/master/.config/shell/profile"
```
