# alexdachin/dotfiles architecture

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

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

## Overview

##### Main Components

a. Shell Environment
- Zsh configuration (.zshrc, .zprofile)
- Bash configuration (.bashrc, .bash_profile)

b. Editor Configurations
- Neovim configuration cluster (.config/nvim/*)
- Doom Emacs configuration (.doom.d/*)
- IdeaVim configuration (.ideavimrc)

c. Terminal Configurations
- Kitty terminal (.config/kitty/)
- TMux configuration (.tmux.conf)
- Terminal theme (terminal/Nord/)

d. Version Control
- Git configuration (.gitconfig)

**┌─────────────────────────────────────────┐**
- Shell Environment            │
- ┤
- ┌─────────┐ ┌──────────┐ ┌───────────┐ │
- Editors │ │ Terminal │ │   Tools   │ │
- ┘ └──────────┘ └───────────┘ │
- ┘

##### Component Relationships

a. Neovim Configuration Hierarchy:
**nvim/**
- init.vim (Entry point)
- lua/
- plugins.lua (Plugin management)
- terminal.lua (Terminal integration)
- plugin-config/ (Individual plugin configurations)

b. Doom Emacs Configuration Hierarchy:
**.doom.d/**
- init.el (Core initialization)
- config.el (Custom configuration)
- packages.el (Package management)

##### Implementation Details

Use these symbols and conventions:
- Diamonds: Configuration entry points
- Rectangles: Major components
- Rounded rectangles: Plugin/extension systems

##### Additional Notes

- Setup.sh script as an initialization component
- Extensibility point for .gitconfig_extra
- Nord theme as a shared resource
- Spotify integration script as an auxiliary component

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph Shell
        ZSH[".zshrc/.zprofile"]:::shell
        BASH[".bashrc/.bash_profile"]:::shell
    end

    subgraph Editors
        NVIM["Neovim"]:::editor
        DOOM["Doom Emacs"]:::editor
        IDEA["IdeaVim"]:::editor

        subgraph "Neovim Configuration"
            INIT["init.vim"]:::config
            PLUG["plugins.lua"]:::config
            TERM["terminal.lua"]:::config
            
            subgraph "Plugin Config"
                LSP["LSP Config"]:::plugin
                TREE["Treesitter"]:::plugin
                CMP["nvim-cmp"]:::plugin
                NEOT["neo-tree"]:::plugin
                LINE["lualine"]:::plugin
            end
        end

        subgraph "Doom Configuration"
            DINIT["init.el"]:::config
            DCONF["config.el"]:::config
            DPACK["packages.el"]:::config
        end
    end

    subgraph Terminal
        KITTY["Kitty"]:::terminal
        TMUX["TMux"]:::terminal
        THEME["Nord Theme"]:::theme
    end

    subgraph Tools
        GIT["Git Config"]:::tool
        SETUP["setup.sh"]:::script
        SPOT["Spotify Integration"]:::script
    end

    %% Relationships
    ZSH --> NVIM
    ZSH --> DOOM
    BASH --> NVIM
    BASH --> DOOM

    INIT --> PLUG
    INIT --> TERM
    PLUG --> LSP
    PLUG --> TREE
    PLUG --> CMP
    PLUG --> NEOT
    PLUG --> LINE

    DINIT --> DCONF
    DINIT --> DPACK

    THEME --> KITTY
    THEME --> TMUX
    THEME --> NVIM
    THEME --> DOOM

    SETUP --> ZSH
    SETUP --> BASH
    SETUP --> GIT

    %% Click events
    click ZSH "https://github.com/alexdachin/dotfiles/blob/master//.zshrc"
    click BASH "https://github.com/alexdachin/dotfiles/blob/master//.bashrc"
    click INIT "https://github.com/alexdachin/dotfiles/blob/master//.config/nvim/init.vim"
    click PLUG "https://github.com/alexdachin/dotfiles/blob/master//.config/nvim/lua/plugins.lua"
    click TERM "https://github.com/alexdachin/dotfiles/blob/master//.config/nvim/lua/terminal.lua"
    click LSP "https://github.com/alexdachin/dotfiles/blob/master//.config/nvim/lua/plugin-config/nvim-lspconfig.lua"
    click TREE "https://github.com/alexdachin/dotfiles/blob/master//.config/nvim/lua/plugin-config/nvim-treesitter.lua"
    click CMP "https://github.com/alexdachin/dotfiles/blob/master//.config/nvim/lua/plugin-config/nvim-cmp.lua"
    click NEOT "https://github.com/alexdachin/dotfiles/blob/master//.config/nvim/lua/plugin-config/neo-tree.lua"
    click LINE "https://github.com/alexdachin/dotfiles/blob/master//.config/nvim/lua/plugin-config/lualine.lua"
    click DOOM "https://github.com/alexdachin/dotfiles/tree/master//.doom.d/"
    click DINIT "https://github.com/alexdachin/dotfiles/blob/master//.doom.d/init.el"
    click DCONF "https://github.com/alexdachin/dotfiles/blob/master//.doom.d/config.el"
    click DPACK "https://github.com/alexdachin/dotfiles/blob/master//.doom.d/packages.el"
    click IDEA "https://github.com/alexdachin/dotfiles/blob/master//.ideavimrc"
    click KITTY "https://github.com/alexdachin/dotfiles/blob/master//.config/kitty/kitty.conf"
    click TMUX "https://github.com/alexdachin/dotfiles/blob/master//.tmux.conf"
    click THEME "https://github.com/alexdachin/dotfiles/blob/master//terminal/Nord/Nord.terminal"
    click GIT "https://github.com/alexdachin/dotfiles/blob/master//.gitconfig"
    click SETUP "https://github.com/alexdachin/dotfiles/blob/master//setup.sh"
    click SPOT "https://github.com/alexdachin/dotfiles/blob/master//current-spotify-track.scpt"

    %% Styles
    classDef shell fill:#3498db,stroke:#2980b9,color:white
    classDef editor fill:#2ecc71,stroke:#27ae60,color:white
    classDef terminal fill:#f1c40f,stroke:#f39c12,color:black
    classDef tool fill:#9b59b6,stroke:#8e44ad,color:white
    classDef config fill:#95a5a6,stroke:#7f8c8d,color:white
    classDef plugin fill:#e74c3c,stroke:#c0392b,color:white
    classDef theme fill:#1abc9c,stroke:#16a085,color:white
    classDef script fill:#34495e,stroke:#2c3e50,color:white
```
