# devdrops/my-dotfiles architecture

> Architecture diagram of the GitHub repository devdrops/my-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/devdrops/my-dotfiles
- Repository: https://github.com/devdrops/my-dotfiles

## Overview

##### Main Components

a. Core Configuration Groups:
- Text Editors (Vim, Neovim, Sublime Text, VS Code)
- Version Control (Git)
- Terminal Multiplexers (Tmux, Tmate)
- Shell Environments (Zsh, Bash)
- Development Tools (Ctags, Terminfo)

b. Custom Tools:
- Utility Binaries (bins directory)
- Custom Scripts
- Templates

**┌─────────────────────────────────────────────────────────┐**
- User Interface Layer                  │
- ┬─────────────┬──────────────┬─────────────┤
- Vim/Neovim │ Sublime Text│   VS Code    │  Terminal   │
- ┴─────────────┴──────────────┴─────────────┘
- ↑            ↑           ↑            ↑
**┌─────────────────────────────────────────────────────────┐**
- Configuration Layer                       │
- ┬─────────────┬─────────────┬───────────────┤
- .vim/      │  .terminfo/ │   git/      │    tmux/      │
- nvim/      │  .ctags/    │             │    tmate/     │
- ┴─────────────┴─────────────┴───────────────┘
- ↑            ↑           ↑            ↑
**┌─────────────────────────────────────────────────────────┐**
- Utility Layer                          │
- ┬─────────────┬─────────────────────────────┤
- bins/     │    sh/      │      templates/             │
- ┴─────────────┴─────────────────────────────┘

##### Important Details

a. Vim/Neovim Section:
- Plugin-free architecture
- Integration with development tools

b. Git Configuration:
- Hooks system
- Custom templates
- Integration with delta

c. Terminal Environment:
- Cross-platform compatibility (Linux/MacOS)
- Shell customizations
- Terminal multiplexer configurations

##### Implementation Notes

- Version requirements as annotations

##### Key Relationships to Highlight

- Vim/Neovim ↔ Ctags integration
- Terminal ↔ Tmux/Tmate interaction
- Git hooks ↔ Template system
- Cross-tool syntax highlighting

Remember to include a note about the cross-platform compatibility and any OS-specific adaptations, particularly for Linux Mint and MacOS.

This system design should help developers understand how the different components interact and how to maintain or extend the configuration system while keeping its minimalist, hands-on philosophy intact.

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph UI["User Interface Layer"]
        VIM["Vim/Neovim"]:::editor
        ST["Sublime Text"]:::editor
        VSC["VS Code"]:::editor
        TERM["Terminal"]:::terminal
    end

    subgraph CONFIG["Configuration Layer"]
        direction TB
        subgraph EDITOR["Editor Configurations"]
            VIMCONF["Vim Config"]:::editor
            NVIMCONF["Neovim Config"]:::editor
            STCONF["Sublime Config"]:::editor
            VSCCONF["VS Code Config"]:::editor
            FTDETECT["File Type Detection"]:::editor
            SYNTAX["Syntax Definitions"]:::editor
            PLUGINS["Custom Plugins"]:::editor
        end

        subgraph TERMINAL["Terminal Configurations"]
            TMUXCONF["Tmux Config"]:::terminal
            TMATECONF["Tmate Config"]:::terminal
            TERMINFO["Terminfo"]:::terminal
        end

        subgraph VCS["Version Control"]
            GITCONF["Git Config"]:::vcs
            GITHOOKS["Git Hooks"]:::vcs
        end

        subgraph DEVTOOLS["Development Tools"]
            CTAGS["Ctags"]:::devtool
        end
    end

    subgraph UTIL["Utility Layer"]
        BINS["Utility Binaries"]:::util
        SHELL["Shell Scripts"]:::util
        TEMPLATES["Templates"]:::util
    end

    %% Relationships
    VIM --> VIMCONF
    VIM --> NVIMCONF
    ST --> STCONF
    VSC --> VSCCONF
    TERM --> TMUXCONF
    TERM --> TMATECONF
    TERM --> TERMINFO

    VIMCONF --> FTDETECT
    VIMCONF --> SYNTAX
    VIMCONF --> PLUGINS
    VIMCONF --> TEMPLATES
    VIMCONF --> CTAGS

    GITCONF --> GITHOOKS
    GITHOOKS --> TEMPLATES

    %% Click events
    click VIMCONF "https://github.com/devdrops/my-dotfiles/tree/main/.vim/"
    click NVIMCONF "https://github.com/devdrops/my-dotfiles/blob/main/nvim/init.vim"
    click STCONF "https://github.com/devdrops/my-dotfiles/blob/main/sublime-text/user-settings.json"
    click VSCCONF "https://github.com/devdrops/my-dotfiles/blob/main/vscode/settings.json"
    click GITCONF "https://github.com/devdrops/my-dotfiles/blob/main/git/.gitconfig"
    click GITHOOKS "https://github.com/devdrops/my-dotfiles/tree/main/git/.githooks_global/"
    click TMUXCONF "https://github.com/devdrops/my-dotfiles/blob/main/tmux/.tmux.conf"
    click TMATECONF "https://github.com/devdrops/my-dotfiles/blob/main/tmate/.tmate.conf"
    click CTAGS "https://github.com/devdrops/my-dotfiles/tree/main/.ctags/"
    click TERMINFO "https://github.com/devdrops/my-dotfiles/tree/main/.terminfo/"
    click BINS "https://github.com/devdrops/my-dotfiles/tree/main/bins/"
    click SHELL "https://github.com/devdrops/my-dotfiles/tree/main/sh/"
    click TEMPLATES "https://github.com/devdrops/my-dotfiles/tree/main/.vim/templates/"
    click PLUGINS "https://github.com/devdrops/my-dotfiles/tree/main/.vim/plugin/devdrops/"
    click FTDETECT "https://github.com/devdrops/my-dotfiles/tree/main/.vim/ftdetect/"
    click SYNTAX "https://github.com/devdrops/my-dotfiles/tree/main/.vim/syntax/"

    %% Styles
    classDef editor fill:#3498db,stroke:#2980b9,color:white
    classDef terminal fill:#e67e22,stroke:#d35400,color:white
    classDef vcs fill:#2ecc71,stroke:#27ae60,color:white
    classDef devtool fill:#9b59b6,stroke:#8e44ad,color:white
    classDef util fill:#95a5a6,stroke:#7f8c8d,color:white

    %% Legend
    subgraph Legend
        E[Editor]:::editor
        T[Terminal]:::terminal
        V[Version Control]:::vcs
        D[Development Tools]:::devtool
        U[Utilities]:::util
    end
```
