# kleutzinger/dotfiles architecture

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

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

## Overview

##### Main Components

a) Configuration Management Layer
- YADM (Core dotfiles manager)
- System Configuration Files
- User Configuration Files

b) System Integration Components
- Window Manager (Xfwm4)
- Desktop Environment (Xfce)
- Keyboard Layout (Colemak)
- Shell Environment (Fish)

c) Application Configurations
- Terminal (Kitty)
- Editor (Neovim)
- Various Tools (atuin, lazygit, etc.)

d) Custom Scripts Layer
- System Management Scripts
- Utility Scripts
- Automation Scripts

**┌─ System Layer ─────────────────────────┐**
- OS (ArcoLinux)                         │
- Window Manager (Xfwm4) + DE (Xfce)    │
- Keyboard Layout (Colemak)              │
- ┬─┘

**┌─ Configuration Management Layer ──────┼─┐**
- YADM                                 │ │
- Dotfiles Repository              │ │
- System Configs                │ │
- User Configs                  │ │
- Bootstrap Scripts             │ │
- ┼─┘

**┌─ Application Layer ──────────────────┼─┐**
- Terminal (Kitty)                     │ │
- Editor (Neovim)                      │ │
- Shell (Fish)                         │ │
- Development Tools                    │ │
- ┼─┘

**┌─ Custom Scripts Layer ────────────────┼─┐**
- System Management                    │ │
- Utility Scripts                      │ │
- Automation Tools                     │ │
- ┘ │

**┌─ Keybinding Layer ───────────────────┐ │**
- SXHKD                                │ │
- Global Shortcuts                     │ │
- Application Shortcuts                │ │
- ┘

##### Important Relationships

- How keybindings interact with applications
- Script dependencies and interactions
- Configuration file relationships

##### Additional Elements

- Version information for key components
- File locations for important configurations
- Backup and synchronization paths

## Diagram (Mermaid)

```mermaid
graph TB
    %% Styles
    classDef system fill:#b3d1ff,stroke:#333
    classDef config fill:#90EE90,stroke:#333
    classDef app fill:#FFB366,stroke:#333
    classDef script fill:#DDA0DD,stroke:#333
    classDef keybind fill:#FFE5B4,stroke:#333

    %% System Layer
    subgraph SYS["System Layer"]
        OS["ArcoLinux"]
        WM["Window Manager (Xfwm4)"]
        DE["Desktop Environment (Xfce)"]
        KB["Keyboard Layout (Colemak)"]
    end
    class OS,WM,DE,KB system

    %% Configuration Management Layer
    subgraph CFG["Configuration Management"]
        YADM["YADM Core"]
        DR["Dotfiles Repository"]
        BS["Bootstrap Scripts"]
        SC["System Configs"]
        UC["User Configs"]
    end
    class YADM,DR,BS,SC,UC config

    %% Application Layer
    subgraph APP["Application Layer"]
        TERM["Terminal (Kitty)"]
        NVIM["Editor (Neovim)"]
        FISH["Shell (Fish)"]
        TOOLS["Development Tools"]
    end
    class TERM,NVIM,FISH,TOOLS app

    %% Custom Scripts Layer
    subgraph SCR["Custom Scripts Layer"]
        SMS["System Management"]
        US["Utility Scripts"]
        AT["Automation Tools"]
    end
    class SMS,US,AT script

    %% Keybinding Layer
    subgraph KEY["Keybinding Layer"]
        SXHKD["SXHKD"]
        GS["Global Shortcuts"]
        AS["Application Shortcuts"]
    end
    class SXHKD,GS,AS keybind

    %% Relationships
    OS --> WM & DE
    YADM --> DR
    DR --> SC & UC & BS
    SXHKD --> WM
    SXHKD --> TERM & NVIM
    BS --> TOOLS
    FISH --> TOOLS

    %% Click Events
    click YADM "https://github.com/kleutzinger/dotfiles/tree/master/.config/yadm/bootstrap"
    click BS "https://github.com/kleutzinger/dotfiles/blob/master/.config/yadm/bootstrap-arch.fish"
    click WM "https://github.com/kleutzinger/dotfiles/tree/master/.config/xfce4/xfconf/xfce-perchannel-xml/"
    click KB "https://github.com/kleutzinger/dotfiles/blob/master/.config/nvim/lua/kevin/core/colemak.lua"
    click FISH "https://github.com/kleutzinger/dotfiles/blob/master/.config/fish/config.fish"
    click TERM "https://github.com/kleutzinger/dotfiles/blob/master/.config/kitty/kitty.conf"
    click NVIM "https://github.com/kleutzinger/dotfiles/blob/master/.config/nvim/init.lua"
    click TOOLS "https://github.com/kleutzinger/dotfiles/blob/master/.config/lazygit/config.yml"
    click SMS "https://github.com/kleutzinger/dotfiles/tree/master/scripts/"
    click US "https://github.com/kleutzinger/dotfiles/blob/master/scripts/window-control.fish"
    click SXHKD "https://github.com/kleutzinger/dotfiles/tree/master/.config/sxhkd/sxhkdrc"
    click GS "https://github.com/kleutzinger/dotfiles/blob/master/.config/xfce4/xfconf/xfce-perchannel-xml/xfce4-keyboard-shortcuts.xml"
    click AS "https://github.com/kleutzinger/dotfiles/blob/master/.config/autostart/sxhkd.desktop"

    %% Legend
    subgraph Legend
        SL["System Components"]:::system
        CL["Configuration Components"]:::config
        AL["Application Components"]:::app
        SCL["Script Components"]:::script
        KL["Keybinding Components"]:::keybind
    end
```
