# vkwhm/dotfiles architecture

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

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

## Overview

##### Main Components Identification

a) Configuration Managers:
- Neovim Configuration Manager
- Shell Environment Manager
- Terminal Emulator Manager (WezTerm)
- Tmux Session Manager

b) Installation System:
- Installation Script Handler
- Symlink Manager
- Cache Manager

**Top Level (User Interface Layer):**
- Terminal Environment
- WezTerm
- Tmux

**Middle Level (Configuration Layer):**
- Shell Environment
- ZSH Configuration
- Powerlevel10k Theme

**Bottom Level (Editor Layer):**
- Neovim
- Vim

##### Component Relationships

a) Installation Flow:
- How install.sh interacts with each component
- Symlink creation paths
- Cache generation processes

b) Plugin Systems:
- Neovim's plugin management system (Lazy.nvim)
- Shell plugin interactions
- WezTerm plugin structure

##### Specific Component Details

For Neovim Configuration:
- Relationship between init.lua and the modular structure
- LSP, debugging, and plugin configurations
- Custom user configuration path (whoami directory)

For Terminal Environment:
- WezTerm's event system
- Tmux session management
- Shell integration points

##### Key Features to Highlight

- Modular architecture of Neovim configuration
- Shell environment integration
- Terminal multiplexing capabilities
- Theme and appearance management
- Development tool integration points

##### Implementation Details

Technical aspects:
- Lua-based configuration structure
- Shell script integration points
- Cache management system
- Theme management across components

##### External Dependencies

Connections to:
- Nerd Fonts
- Language servers
- External tools and utilities
- Plugin repositories

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph Installation
        Install[Installation Script]:::install
        SymLink[Symlink Manager]:::install
        Cache[Cache Manager]:::cache
    end

    subgraph "Terminal Environment"
        WezTerm[WezTerm]:::terminal
        Tmux[Tmux]:::terminal
        
        subgraph "WezTerm Components"
            WezConfig["WezTerm Config"]:::config
            WezEvents["Events Handler"]:::config
            WezKeys["Keymaps"]:::config
            WezPlugins["Plugins"]:::plugin
            WezThemes["Themes"]:::theme
        end
    end

    subgraph "Shell Environment"
        ZSH[ZSH Configuration]:::shell
        P10K[Powerlevel10k]:::theme
        ShellConfig["Shell Config"]:::config
        ShellAliases["Aliases"]:::config
        ShellFunctions["Functions"]:::config
    end

    subgraph "Editor Environment"
        Neovim[Neovim]:::editor
        
        subgraph "Core Configuration"
            CoreInit["Core Init"]:::config
            CoreOpts["Options"]:::config
            CoreKeys["Keymaps"]:::config
        end

        subgraph "Plugin System"
            LazyNvim["Lazy.nvim"]:::plugin
            PluginInit["Plugin Init"]:::plugin
        end

        subgraph "LSP System"
            LSPConfig["LSP Config"]:::lsp
            Mason["Mason"]:::lsp
            Formatting["Formatting"]:::lsp
            Linting["Linting"]:::lsp
        end

        subgraph "Debug System"
            DAP["nvim-dap"]:::debug
            DAPUI["DAP UI"]:::debug
            DAPPython["DAP Python"]:::debug
        end

        subgraph "Themes"
            Catppuccin["Catppuccin"]:::theme
            TokyoNight["TokyoNight"]:::theme
            BatThemes["BAT Themes"]:::theme
        end
    end

    Install --> SymLink
    Install --> Cache
    Install --> WezTerm
    Install --> Tmux
    Install --> ZSH
    Install --> Neovim

    WezTerm --> WezConfig
    WezConfig --> WezEvents
    WezConfig --> WezKeys
    WezConfig --> WezPlugins
    WezConfig --> WezThemes

    ZSH --> ShellConfig
    ZSH --> ShellAliases
    ZSH --> ShellFunctions
    ZSH --> P10K

    Neovim --> CoreInit
    CoreInit --> CoreOpts
    CoreInit --> CoreKeys
    Neovim --> LazyNvim
    LazyNvim --> PluginInit
    Neovim --> LSPConfig
    LSPConfig --> Mason
    LSPConfig --> Formatting
    LSPConfig --> Linting
    Neovim --> DAP
    DAP --> DAPUI
    DAP --> DAPPython
    Neovim --> Catppuccin
    Neovim --> TokyoNight

    %% Click Events
    click Install "https://github.com/vkwhm/dotfiles/blob/main/install.sh"
    click WezConfig "https://github.com/vkwhm/dotfiles/blob/main/wezterm/wezterm.lua"
    click WezEvents "https://github.com/vkwhm/dotfiles/blob/main/wezterm/events.lua"
    click WezKeys "https://github.com/vkwhm/dotfiles/blob/main/wezterm/keymaps.lua"
    click WezPlugins "https://github.com/vkwhm/dotfiles/blob/main/wezterm/plugins.lua"
    click WezThemes "https://github.com/vkwhm/dotfiles/blob/main/wezterm/themes.lua"
    click ShellConfig "https://github.com/vkwhm/dotfiles/blob/main/shell/config.sh"
    click ShellAliases "https://github.com/vkwhm/dotfiles/blob/main/shell/aliases.sh"
    click ShellFunctions "https://github.com/vkwhm/dotfiles/blob/main/shell/functions.sh"
    click Tmux "https://github.com/vkwhm/dotfiles/blob/main/tmux.conf"
    click CoreInit "https://github.com/vkwhm/dotfiles/blob/main/nvim/lua/whoami/core/init.lua"
    click CoreOpts "https://github.com/vkwhm/dotfiles/blob/main/nvim/lua/whoami/core/options.lua"
    click CoreKeys "https://github.com/vkwhm/dotfiles/blob/main/nvim/lua/whoami/core/keymaps.lua"
    click LazyNvim "https://github.com/vkwhm/dotfiles/blob/main/nvim/lua/config/lazy.lua"
    click PluginInit "https://github.com/vkwhm/dotfiles/blob/main/nvim/lua/whoami/plugins/init.lua"
    click LSPConfig "https://github.com/vkwhm/dotfiles/blob/main/nvim/lua/whoami/plugins/lsp/lspconfig.lua"
    click Mason "https://github.com/vkwhm/dotfiles/blob/main/nvim/lua/whoami/plugins/lsp/mason.lua"
    click Formatting "https://github.com/vkwhm/dotfiles/blob/main/nvim/lua/whoami/plugins/lsp/formatting.lua"
    click Linting "https://github.com/vkwhm/dotfiles/blob/main/nvim/lua/whoami/plugins/lsp/linting.lua"
    click DAP "https://github.com/vkwhm/dotfiles/blob/main/nvim/lua/whoami/plugins/debug/nvim-dap.lua"
    click DAPUI "https://github.com/vkwhm/dotfiles/blob/main/nvim/lua/whoami/plugins/debug/nvim-dap-ui.lua"
    click DAPPython "https://github.com/vkwhm/dotfiles/blob/main/nvim/lua/whoami/plugins/debug/nvim-dap-python.lua"
    click Catppuccin "https://github.com/vkwhm/dotfiles/blob/main/nvim/lua/whoami/plugins/catppuccin.lua"
    click TokyoNight "https://github.com/vkwhm/dotfiles/blob/main/nvim/lua/whoami/plugins/tokyonight.lua"
    click BatThemes "https://github.com/vkwhm/dotfiles/tree/main/bat-config/themes"

    %% Styles
    classDef install fill:#FFA500,stroke:#333,stroke-width:2px
    classDef cache fill:#800080,stroke:#333,stroke-width:2px
    classDef terminal fill:#4169E1,stroke:#333,stroke-width:2px
    classDef shell fill:#20B2AA,stroke:#333,stroke-width:2px
    classDef editor fill:#4682B4,stroke:#333,stroke-width:2px
    classDef config fill:#87CEEB,stroke:#333,stroke-width:2px
    classDef plugin fill:#98FB98,stroke:#333,stroke-width:2px
    classDef theme fill:#DDA0DD,stroke:#333,stroke-width:2px
    classDef lsp fill:#FFD700,stroke:#333,stroke-width:2px
    classDef debug fill:#FF6347,stroke:#333,stroke-width:2px
```
