# destag/dotfiles architecture

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

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

## Overview

##### Main Components Organization

a) Core Configuration Manager

- Terminal Environment (Blue)
- Alacritty (terminal emulator)
- Tmux (terminal multiplexer)
- Oh My Posh (shell prompt)
- Zsh (shell)

- Development Tools (Green)
- Neovim (with detailed sub-components)
- Git configurations
- ASDF version manager
- Database configs (PostgreSQL, SQLite)

- Application Launchers (Orange)
- Ulauncher with extensions
- Theme configurations

- System Scripts (Yellow)
- Installation scripts
- Database runners
- Kubernetes tools

- AI features (ai.lua)
- Code features (code.lua)
- UI components (ui.lua)
- Editor features (edit.lua)
- Testing capabilities (test.lua)
- Workflow enhancements (workflow.lua)

##### Installation Flow
- Initial clone
- Dotbot installation
- ASDF tool installation
- Font installation
- Keybinding setup

##### Important Details to Capture

- How dotbot orchestrates the entire configuration process
- Modular nature of the configuration (separate configs for different tools)
- External dependencies (fonts, system tools)
- Relationship between different configuration components

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Core Configuration Manager
    subgraph Core
        Dotbot(("Dotbot")):::core
        InstallConfig["Installation Config"]:::config
        InstallScript["Installation Script"]:::script
    end

    %% Terminal Environment
    subgraph Terminal
        Alacritty["Alacritty"]:::terminal
        Tmux["Tmux"]:::terminal
        OhMyPosh["Oh My Posh"]:::terminal
        Zsh["Zsh"]:::terminal
    end

    %% Development Tools
    subgraph DevTools
        Git["Git Config"]:::dev
        ASDF["ASDF Manager"]:::dev
        Postgres[(PostgreSQL)]:::db
        SQLite[(SQLite)]:::db
        Terraform["Terraform"]:::dev
    end

    %% Neovim Configuration
    subgraph Neovim
        NVInit["Init"]:::neovim
        AI["AI Features"]:::neovim
        Code["Code Features"]:::neovim
        UI["UI Components"]:::neovim
        Edit["Editor Features"]:::neovim
        Test["Testing"]:::neovim
        Workflow["Workflow"]:::neovim
    end

    %% Application Launchers
    subgraph Launchers
        Ulauncher["Ulauncher"]:::launcher
        UTheme["Theme"]:::launcher
        UExtensions["Extensions"]:::launcher
    end

    %% System Scripts
    subgraph Scripts
        DBRunners["Database Runners"]:::script
        K8sTools["Kubernetes Tools"]:::script
        GHCli["GitHub CLI"]:::script
    end

    %% Connections
    Dotbot --> InstallConfig
    Dotbot --> InstallScript
    Dotbot --> Terminal
    Dotbot --> DevTools
    Dotbot --> Neovim
    Dotbot --> Launchers
    Dotbot --> Scripts

    %% Click Events
    click Dotbot "https://github.com/destag/dotfiles/tree/master/dotbot"
    click InstallConfig "https://github.com/destag/dotfiles/blob/master/install.conf.yaml"
    click InstallScript "https://github.com/destag/dotfiles/tree/master/install"
    click Alacritty "https://github.com/destag/dotfiles/blob/master/config/alacritty/alacritty.toml"
    click Tmux "https://github.com/destag/dotfiles/blob/master/config/tmux.conf"
    click OhMyPosh "https://github.com/destag/dotfiles/blob/master/config/ohmyposh/zen.toml"
    click Zsh "https://github.com/destag/dotfiles/tree/master/config/zshrc"
    click Git "https://github.com/destag/dotfiles/tree/master/config/gitconfig"
    click ASDF "https://github.com/destag/dotfiles/tree/master/config/asdfrc"
    click Postgres "https://github.com/destag/dotfiles/tree/master/config/psqlrc"
    click SQLite "https://github.com/destag/dotfiles/tree/master/config/sqliterc"
    click Terraform "https://github.com/destag/dotfiles/tree/master/config/terraformrc"
    click NVInit "https://github.com/destag/dotfiles/blob/master/nvim/init.lua"
    click AI "https://github.com/destag/dotfiles/blob/master/nvim/lua/plugins/ai.lua"
    click Code "https://github.com/destag/dotfiles/blob/master/nvim/lua/plugins/code.lua"
    click UI "https://github.com/destag/dotfiles/blob/master/nvim/lua/plugins/ui.lua"
    click Edit "https://github.com/destag/dotfiles/blob/master/nvim/lua/plugins/edit.lua"
    click Test "https://github.com/destag/dotfiles/blob/master/nvim/lua/plugins/test.lua"
    click Workflow "https://github.com/destag/dotfiles/blob/master/nvim/lua/plugins/workflow.lua"
    click Ulauncher "https://github.com/destag/dotfiles/blob/master/config/ulauncher/settings.json"
    click UTheme "https://github.com/destag/dotfiles/tree/master/config/ulauncher/user-themes/TokyoNight"
    click UExtensions "https://github.com/destag/dotfiles/blob/master/config/ulauncher/extensions.json"
    click DBRunners "https://github.com/destag/dotfiles/tree/master/scripts"
    click K8sTools "https://github.com/destag/dotfiles/tree/master/scripts"
    click GHCli "https://github.com/destag/dotfiles/blob/master/scripts/gh-install.sh"

    %% Styles
    classDef core fill:#FF6B6B,stroke:#333,stroke-width:2px
    classDef config fill:#4ECDC4,stroke:#333
    classDef script fill:#FFE66D,stroke:#333
    classDef terminal fill:#45B7D1,stroke:#333
    classDef dev fill:#96CEB4,stroke:#333
    classDef db fill:#FFEEAD,stroke:#333
    classDef neovim fill:#D4A5A5,stroke:#333
    classDef launcher fill:#FF9999,stroke:#333

    %% Legend
    subgraph Legend
        L1(("Core")):::core
        L2["Config"]:::config
        L3["Script"]:::script
        L4["Terminal"]:::terminal
        L5["Dev Tool"]:::dev
        L6[(Database)]:::db
        L7["Neovim"]:::neovim
        L8["Launcher"]:::launcher
    end
```
