# eckii24/dotfiles architecture

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

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

## Overview

##### Main Components

a. Configuration Management Layer
- YADM Core (central management system)
- Bootstrap System
- Class/OS-specific configurations (##class.* and ##os.* files)

b. Development Environment Components
- Shell Environment (ZSH)
- Development Tools
- Neovim
- Git
- Terminal Emulators (Alacritty)
- Window Management (i3, rofi)
- Container Environment
- Docker configurations
- Development containers

c. Platform-Specific Adaptations
- Darwin (macOS)
- Linux
- WSL (Windows Subsystem for Linux)

##### Relationship Flows

- YADM → Configuration Files (show template processing)
- Bootstrap Scripts → Installation Targets
- Container Configurations → Development Environments
- Platform-Specific Configs → Respective OS Components

##### Specific Implementation Details

a. Configuration Management:
- YADM's template processing system
- Bootstrap orchestration flow
- Class-based configuration selection

b. Development Environment:
- Terminal stack (Alacritty, Zellij, ZSH)
- Editor stack (Neovim + plugins)
- Tool configurations (Git, FZF, etc.)

c. Container System:
- Base container
- Language-specific containers (PHP, .NET)
- Volume mounting points
- SSH access flow

##### Important Elements to Highlight

- Bootstrap sequence flow
- Configuration template resolution
- Container access patterns
- Cross-platform compatibility layers

##### Specific Features

- Brew package management flow
- SSH key management
- Volume mounting patterns
- Platform-specific tool chains

- Configuration management system
- Development environment setup
- Container-based development environments
- Cross-platform compatibility layers

Use standardized symbols:
- Diamonds for decision points (platform/class selection)
- Rectangles for components

Keep the abstraction level focused on the system architecture while including enough detail to show the sophisticated template-based configuration system and multi-platform support.

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph ConfigManagement
        YADM[YADM Core]
        Bootstrap[Bootstrap System]
        Templates[Template Processing]
    end

    subgraph PlatformSpecific
        Darwin[Darwin/macOS]
        Linux[Linux]
        WSL[WSL]
    end

    subgraph DevEnvironment
        subgraph Shell
            ZSH[ZSH Shell]
            OhMyPosh[Oh My Posh]
            Zellij[Zellij]
        end

        subgraph Tools
            Neovim[Neovim]
            Git[Git Config]
            Alacritty[Alacritty]
        end

        subgraph WM
            i3[i3 WM]
            rofi[rofi]
        end
    end

    subgraph Containers
        BaseContainer[Base Container]
        DotNetContainer[.NET Container]
        PHPContainer[PHP Container]
    end

    subgraph Setup
        SetupScripts[Setup Scripts]
        Brewfile[Brew Packages]
    end

    %% Relationships
    YADM --> Templates
    Templates --> |Config Resolution| DevEnvironment
    Bootstrap --> SetupScripts
    SetupScripts --> Containers
    SetupScripts --> Tools
    
    %% Platform relationships
    Templates --> PlatformSpecific
    Darwin --> Brewfile
    Linux --> SetupScripts
    WSL --> SetupScripts

    %% Container relationships
    BaseContainer --> DotNetContainer
    BaseContainer --> PHPContainer

    %% Styling
    classDef core fill:#2374ab
    classDef tools fill:#57a773
    classDef platform fill:#ff8c42
    classDef container fill:#9b6b9e
    classDef setup fill:#878787

    class YADM,Bootstrap,Templates core
    class Neovim,Git,Alacritty,ZSH,OhMyPosh,Zellij,i3,rofi tools
    class Darwin,Linux,WSL platform
    class BaseContainer,DotNetContainer,PHPContainer container
    class SetupScripts,Brewfile setup

    %% Click events
    click YADM "https://github.com/Eckii24/dotfiles/tree/master/.config/yadm/"
    click Bootstrap "https://github.com/Eckii24/dotfiles/tree/master/.config/yadm/bootstrap"
    click ZSH "https://github.com/Eckii24/dotfiles/tree/master/.config/zsh/"
    click Neovim "https://github.com/Eckii24/dotfiles/tree/master/.config/nvim/"
    click Git "https://github.com/Eckii24/dotfiles/tree/master/.config/git/"
    click Alacritty "https://github.com/Eckii24/dotfiles/tree/master/.config/alacritty/"
    click i3 "https://github.com/Eckii24/dotfiles/tree/master/.config/i3/"
    click rofi "https://github.com/Eckii24/dotfiles/tree/master/.config/rofi/"
    click BaseContainer "https://github.com/Eckii24/dotfiles/blob/master/.config/setup-scripts/base.Dockerfile"
    click DotNetContainer "https://github.com/Eckii24/dotfiles/blob/master/.config/setup-scripts/dotnet.Dockerfile"
    click PHPContainer "https://github.com/Eckii24/dotfiles/blob/master/.config/setup-scripts/php.Dockerfile"
    click Brewfile "https://github.com/Eckii24/dotfiles/blob/master/.config/yadm/Brewfile##os.Darwin"
    click Zellij "https://github.com/Eckii24/dotfiles/tree/master/.config/zellij/"
    click OhMyPosh "https://github.com/Eckii24/dotfiles/tree/master/.config/oh-my-posh/"
    click SetupScripts "https://github.com/Eckii24/dotfiles/blob/master/.config/setup-scripts/setup.sh"
```
