# d4nz-jpg/dotfiles architecture

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

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

## Overview

This dotfiles repository is essentially a sophisticated configuration hub that orchestrates the look and feel of your desktop environment on Arch Linux. The primary purpose of this project is to house all your system and application settings—from window management with Hyprland to terminal configurations with Kitty, and editor setups with Neovim—as well as glue scripts and installation routines that automate the setup process via chezmoi.

##### Main Components
- Dotfiles Repository: Represent the entire collection of configuration files.
- Configuration Management: Emphasize chezmoi as the tool managing synchronization and deployment of these dotfiles.
- Desktop Environment Configuration: Create nodes for each of the “household members” mentioned in the README.
- Hyprland – the Wayland compositor and core of your desktop.
- Kitty – terminal emulator configuration.
- Neovim – editor configurations, plugins, and snippets.
- Zsh with its plugins – interactive shell environment.
- Rofi – application launcher settings.
- Waybar – status bar configuration.
- Wlogout – logout and session handling.
- Auxiliary Components: Include sections for other settings such as:
- Task management (with the associated task hooks and scripts).
- Additional system assets like wallpapers, themes (e.g., for kitty, grub), and private GTK settings.
- Setup scripts and package information for installation automation.

##### Detail the Relationships/Interactions
- Hyprland, Kitty, Neovim, Zsh, Rofi, Waybar, and Wlogout as individual modules, showing that they are independent configuration areas yet part of the unified system.
- Link auxiliary nodes (such as “setup scripts” and “pkgs”) to the “Dotfiles Repository” to show their role in initial installation and updates.
- Interactions where some components depend on common configuration values or scripts (for example, how “scripts” can influence both system settings and application behaviors).

##### Architectural Patterns and Design Principles
- Separation of Concerns: Each tool and its settings have dedicated folders (e.g., dot_config/nvim for Neovim configurations), reflecting a modular design.
- Configuration as Code: All aspects of system personalization are stored as files, which are versioned and portable.
- Automation & Idempotency: The setup scripts and chezmoi integration ensure that the configuration is deployed reliably on Arch Linux.
- Extensibility: The folder structure—especially within Neovim snippets and plugins, as well as zsh_plugins—indicates that the setup is designed to be easily extended with more tools or further customizations.

## Diagram (Mermaid)

```mermaid
graph TB
    %% Management and repository
    CM["Configuration Management (chezmoi)"]:::management
    DS["Dotfiles Repository"]:::repository
    SS["Setup Scripts"]:::management

    %% Core configuration components
    HS["Hyprland Config"]:::core
    KT["Kitty Config"]:::core
    NV["Neovim Config"]:::core
    ZC["Zsh Config"]:::core
    ZP["Zsh Plugins"]:::core
    RF["Rofi Config"]:::core
    WB["Waybar Config"]:::core
    WL["Wlogout Config"]:::core
    TM["Task Management & Hooks"]:::core

    %% Auxiliary components
    AA["Auxiliary Assets (Wallpapers/Themes)"]:::auxiliary
    SP["Setup Packages"]:::auxiliary
    PI["Post Install Script"]:::auxiliary

    %% Connections
    CM -->|"sync"| DS
    SS -->|"automation"| DS
    AA --> DS
    SP --> DS
    PI --> DS

    DS --> HS
    DS --> KT
    DS --> NV
    DS --> ZC
    DS --> ZP
    DS --> RF
    DS --> WB
    DS --> WL
    DS --> TM

    %% Click Events
    click DS "https://github.com/d4nz-jpg/dotfiles/blob/main/README.md"
    click CM "https://github.com/d4nz-jpg/dotfiles/blob/main/.chezmoiignore"
    click HS "https://github.com/d4nz-jpg/dotfiles/tree/main/dot_config/hypr"
    click KT "https://github.com/d4nz-jpg/dotfiles/tree/main/dot_config/kitty"
    click NV "https://github.com/d4nz-jpg/dotfiles/tree/main/dot_config/nvim"
    click ZC "https://github.com/d4nz-jpg/dotfiles/tree/main/dot_zshrc"
    click ZP "https://github.com/d4nz-jpg/dotfiles/tree/main/zsh_plugins"
    click RF "https://github.com/d4nz-jpg/dotfiles/tree/main/dot_config/rofi"
    click WB "https://github.com/d4nz-jpg/dotfiles/tree/main/dot_config/waybar"
    click WL "https://github.com/d4nz-jpg/dotfiles/tree/main/dot_config/wlogout"
    click TM "https://github.com/d4nz-jpg/dotfiles/tree/main/dot_config/task"
    click SS "https://github.com/d4nz-jpg/dotfiles/tree/main/setup/scripts"
    click AA "https://github.com/d4nz-jpg/dotfiles/tree/main/wallpapers"
    click SP "https://github.com/d4nz-jpg/dotfiles/tree/main/setup/pkgs"
    click PI "https://github.com/d4nz-jpg/dotfiles/blob/main/run_after_install_pkgs.sh"

    %% Styles
    classDef management fill:#a2d2ff,stroke:#000,stroke-width:2px;
    classDef repository fill:#FFECB3,stroke:#000,stroke-width:2px;
    classDef core fill:#cce5ff,stroke:#000,stroke-width:2px;
    classDef auxiliary fill:#d4edda,stroke:#000,stroke-width:2px;
```
