# devout-coder/dotfiles architecture

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

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

## Overview

##### Project type and purpose
- This is a “dotfiles” repository meant to version-control and deploy user configuration across a Linux desktop environment.
- It contains shell configurations (bash, zsh), editor configs (vim, Neovim), window-manager settings (Cinnamon, Hyprland, XFCE), status bars (Waybar, Plank, Mako, Dunst), autostart entries, cron jobs, and various helper scripts.

##### File structure
- Top-level files:
- .gitignore, README.md – Git housekeeping
- backup_stuff.sh, create_symlinks.sh – helper scripts for bootstrapping your home directory.
- Top-level directories each map to a component or application:
- bash, zsh, vim, tmux, nvim – shell & editor config
- auto-start, cron – startup scripts and scheduled jobs
- cinnamon, hyprland, xfce – window manager DE settings
- waybar, plank, mako, dunst, wofi, thunar – status bar, docks, notification & launcher configs
- Within each directory you see the config files or scripts that will be placed under ~/.config/<app>.

##### README
- Confirms this is a personal dotfiles collection for shell/editor/desktop customizations.

##### Elements
- Green for source-control/infra (Git, scripts)
- Blue for runtime components (shells, editors, WM, status bars)
- Orange for scheduler/autostart
- Rectangles for services/apps

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Infra Components
    GitRepo["Git Repository"]:::infra
    Backup["Backup Script"]:::infra
    Symlink["Symlink Script"]:::infra

    %% Storage
    Home["Home Directory"]:::storage

    %% Scheduler and Autostart
    Cron["Cron Scheduler"]:::schedule
    Autostart["XDG Autostart"]:::schedule

    %% Runtime Components
    subgraph "Shells & CLI Tools"
        direction TB
        Bash["Bash Configuration"]:::runtime
        Zsh["Zsh Configuration"]:::runtime
        Tmux["Tmux Configuration"]:::runtime
    end

    subgraph Editors
        direction TB
        Vim["Vim Configuration"]:::runtime
        Nvim["Neovim Configuration"]:::runtime
    end

    subgraph "Window Managers & DEs"
        direction TB
        Cinnamon["Cinnamon Settings"]:::runtime
        Hyprland["Hyprland Configuration"]:::runtime
        XFCE["XFCE Settings"]:::runtime
    end

    subgraph "UI Widgets & Status Bars"
        direction TB
        Waybar["Waybar"]:::runtime
        Plank["Plank"]:::runtime
        Mako["Mako Notifications"]:::runtime
        Dunst["Dunst Notifications"]:::runtime
        Wofi["Wofi Launcher"]:::runtime
        Thunar["Thunar Shortcuts"]:::runtime
        Redshift["Redshift"]:::runtime
        Swaylock["Swaylock"]:::runtime
        Kitty["Kitty Terminal"]:::runtime
    end

    %% Flows
    GitRepo -->|clone/pull| Backup
    GitRepo -->|clone/pull| Symlink
    Backup -->|backup existing| Home
    Symlink -->|create symlinks| Home

    Home -->|"source"| Bash
    Home -->|"source"| Zsh
    Home -->|"load"| Tmux

    Home -->|"read config"| Vim
    Home -->|"read init.lua"| Nvim

    Home -->|"read config"| Cinnamon
    Home -->|"read config"| Hyprland
    Home -->|"read config"| XFCE

    Autostart -->|launch at login| Waybar
    Autostart -->|launch at login| Plank
    Autostart -->|launch at login| Mako
    Autostart -->|launch at login| Dunst
    Autostart -->|launch at login| Wofi
    Autostart -->|launch at login| Thunar
    Autostart -->|launch at login| Redshift
    Autostart -->|launch at login| Swaylock

    Cron -->|schedule jobs| Home
    Cron -->|run scripts| Hyprland
    Cron -->|run scripts| Zsh
    Cron -->|run scripts| Waybar

    %% Click Events
    click Backup "https://github.com/devout-coder/dotfiles/blob/main/backup_stuff.sh"
    click Symlink "https://github.com/devout-coder/dotfiles/blob/main/create_symlinks.sh"
    click Bash "https://github.com/devout-coder/dotfiles/blob/main/bash/.bashrc"
    click Zsh "https://github.com/devout-coder/dotfiles/blob/main/zsh/.zshrc"
    click Tmux "https://github.com/devout-coder/dotfiles/blob/main/tmux/.tmux.conf"
    click Vim "https://github.com/devout-coder/dotfiles/blob/main/vim/.vimrc"
    click Nvim "https://github.com/devout-coder/dotfiles/blob/main/nvim/.config/nvim/init.lua"
    click Cinnamon "https://github.com/devout-coder/dotfiles/tree/main/cinnamon/.config/cinnamon/"
    click Hyprland "https://github.com/devout-coder/dotfiles/blob/main/hyprland/.config/hypr/hyprland.conf"
    click XFCE "https://github.com/devout-coder/dotfiles/tree/main/xfce/.config/xfce4/"
    click Waybar "https://github.com/devout-coder/dotfiles/blob/main/waybar/.config/waybar/config.jsonc"
    click Plank "https://github.com/devout-coder/dotfiles/tree/main/plank/.config/plank/dock1/"
    click Mako "https://github.com/devout-coder/dotfiles/tree/main/mako/.config/mako/config"
    click Dunst "https://github.com/devout-coder/dotfiles/tree/main/dunst/dunstrc"
    click Wofi "https://github.com/devout-coder/dotfiles/tree/main/wofi/.config/wofi/config"
    click Thunar "https://github.com/devout-coder/dotfiles/blob/main/thunar/.config/Thunar/uca.xml"
    click Redshift "https://github.com/devout-coder/dotfiles/blob/main/redshift/.config/redshift.conf"
    click Swaylock "https://github.com/devout-coder/dotfiles/tree/main/swaylock/.config/swaylock/config"
    click Kitty "https://github.com/devout-coder/dotfiles/blob/main/kitty/.config/kitty/kitty.conf"
    click Autostart "https://github.com/devout-coder/dotfiles/tree/main/auto-start/.config/autostart/"
    click Cron "https://github.com/devout-coder/dotfiles/blob/main/cron/all_crons.txt"

    %% Styles
    classDef infra fill:#e0f7e9,stroke:#2e7d32,color:#2e7d32;
    classDef storage fill:#fff3e0,stroke:#ef6c00,color:#e65100;
    classDef schedule fill:#fff8e1,stroke:#ff8f00,color:#ef6c00;
    classDef runtime fill:#e3f2fd,stroke:#1976d2,color:#0d47a1;
```
