# rchrdwllm/dotfiles architecture

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

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

## Overview

This project is essentially a set of dotfiles ("rice") for configuring a Hyprland desktop environment on Arch Linux along with theming and integration for various applications. The primary purpose is to create a cohesive, dynamic, and attractive desktop setup that responds to wallpaper changes (using Pywal) and applies consistent theming across applications and system components.

##### Main Components
- Desktop Environment & Window Manager: Clearly mark Hyprland as the central window manager with its configuration file (hyprland.conf) and associated scripts (for brightness, volume, workspace switching, etc.).
- Application Configurations: Create a segment for app-specific configurations. This includes:
- BetterDiscord (with plugins and themes under .config/BetterDiscord)
- Firefox (custom homepage, userChrome.css, and additional theming instructions)
- Terminal apps (kitty settings)
- File managers and other utilities (ranger, mako, etc.)
- Manager & SDDM: Indicate configuration files in both lib/sddm and usr/share/sddm – these control the login screen and initial system boot visuals.
- Scripts & Utilities: Represent the custom scripts that adjust brightness, volume, wallpaper changes, and other system utilities (found in hypr/scripts, rofi/scripts, and waybar/scripts).

##### Relationships & Interactions
- That the system’s workspaces are pre-configured to launch specific applications (e.g., workspace 1 for Terminal, workspace 3 for browsers, etc.). Indicate the flow from keybind activation to the opening of apps in designated workspaces.
- An interaction from configuration scripts and tools (like hyprcfg and waycfg) that allow runtime editing/reloading of the configuration files.

##### Architectural Patterns & Design Principles
- Modularity: Components such as individual application configurations and various scripts are maintained independently. Emphasize how each configuration file is self-contained while still tying into a unified theming system.

##### Relevant Technologies, Frameworks, and Tools
- Operating System: Arch Linux (with installation instructions for specific packages).
- Hyprland: Modern Wayland compositor/window manager.
- Waybar, Rofi, Kitty, Ranger, Firefox, BetterDiscord, etc.: Show how theming via Pywal and their corresponding configuration files are integrated.
- SDDM: For login and session initiation.
- Zsh with Oh My Zsh and Powerlevel10k: For terminal shell theming.
- Numerous scripts that orchestrate desktop behaviors (workspaces, brightness control, etc.).

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "System Base"
        OS["Arch Linux"]:::system
        subgraph "Display Manager"
            SDDM["SDDM"]:::system
            sddmLib["SDDM Config"]:::config
            sddmTheme["SDDM Theme Config"]:::config
        end
    end

    subgraph "Window Management"
        hyprlandCfg["Hyprland Config"]:::config
        hyprlandScripts["Hyprland Scripts"]:::script
    end

    subgraph "Dynamic Theming"
        pywal["Pywal Color Engine"]:::config
    end

    subgraph "Application Configurations"
        betterdiscord["BetterDiscord Config"]:::config
        firefox["Firefox Config"]:::config
        kitty["Kitty Config"]:::config
        ranger["Ranger Config"]:::config
        rofi["Rofi & Launcher Config"]:::config
    end

    subgraph "Utility Scripts"
        waybarScripts["Waybar Scripts"]:::script
    end

    WallpaperChange["Wallpaper Change(Keybind)"]:::script

    %% Relationships
    OS -->|"launches"| SDDM
    SDDM -->|"loads"| sddmLib
    SDDM -->|"applies"| sddmTheme
    SDDM -->|"starts session"| hyprlandCfg
    hyprlandCfg -->|"reloads via"| hyprlandScripts

    WallpaperChange -->|"triggers"| pywal
    pywal -->|"updates"| hyprlandCfg
    pywal -->|"updates"| betterdiscord
    pywal -->|"updates"| firefox
    pywal -->|"updates"| kitty
    pywal -->|"updates"| ranger
    pywal -->|"updates"| rofi
    pywal -->|"updates"| waybarScripts

    %% Class Definitions
    classDef system fill:#FFD700,stroke:#DAA520,stroke-width:2px;
    classDef config fill:#ADD8E6,stroke:#00008B,stroke-width:2px;
    classDef script fill:#90EE90,stroke:#006400,stroke-width:2px;

    %% Click Events
    click hyprlandCfg "https://github.com/rchrdwllm/dotfiles/blob/master/.config/hypr/hyprland.conf"
    click hyprlandScripts "https://github.com/rchrdwllm/dotfiles/tree/master/.config/hypr/scripts"
    click pywal "https://github.com/rchrdwllm/dotfiles/tree/master/.config/wal/templates"
    click betterdiscord "https://github.com/rchrdwllm/dotfiles/tree/master/.config/BetterDiscord"
    click firefox "https://github.com/rchrdwllm/dotfiles/tree/master/.config/firefox"
    click kitty "https://github.com/rchrdwllm/dotfiles/blob/master/.config/kitty/kitty.conf"
    click ranger "https://github.com/rchrdwllm/dotfiles/tree/master/.config/ranger"
    click sddmLib "https://github.com/rchrdwllm/dotfiles/tree/master/lib/sddm"
    click sddmTheme "https://github.com/rchrdwllm/dotfiles/tree/master/usr/share/sddm/themes"
    click rofi "https://github.com/rchrdwllm/dotfiles/tree/master/.config/rofi"
    click waybarScripts "https://github.com/rchrdwllm/dotfiles/tree/master/.config/waybar/scripts"
```
