# uliboooo/dotfiles architecture

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

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

## Overview

##### Project type and purpose
- This is a personal “dotfiles” repository. Its purpose is to centralize and version-control user configuration files for shells (Zsh, Starship), editors (Neovim, Vim, Zed), terminals (Alacritty, Wezterm), and various command-line utilities. A bootstrap script (`setup.sh` or `setup_arch.bash`) installs dependencies and creates symlinks from the home directory to the stored configs.

##### File structure
- Top-level artifacts
- setup scripts: `setup_arch.bash`, `vm-run.sh`, `tools/zenn_push.bash`
- configuration directories: `common-lisp`, `help_md`, and `usr/.config/...`
- dotfiles in `usr/`—shell configs (`.zshrc`, `.tmux.conf`), editor configs (`.vimrc`, Emacs under `usr/emacs`), plus per-tool theme files.
- Patterns
- Everything lives under `usr/` to mirror `~/.config` and home-dir files.
- `setup.sh` (implied) clones the repo, then runs `setup/links.sh` to create symbolic links.
- The repo is OS-agnostic, supporting multiple package managers (Homebrew, APT, DNF, Pacman).

##### README for additional insights
- It describes a two-step install: clone and run `setup.sh`.
- The bootstrap installs required packages, then symlinks config files into `$HOME`.

##### Elements
[User], [GitHub Repo], [Bootstrap Script], [Package Manager], [Linker Script], [Home Directory], [Shell & Tools]
- User → GitHub Repo (clone)
- User → Bootstrap Script (execute)
- Bootstrap Script → Package Manager (install)
- Bootstrap Script → Linker Script (invoke)
- Linker Script → Home Directory (create symlinks)
- Home Directory → Tools (config consumption)

## Diagram (Mermaid)

```mermaid
flowchart TD
    User["User"]:::user
    GitHub["GitHub Repo<br/>(Dotfiles Monorepo)"]:::external
    User -->|"git clone"| GitHub

    subgraph "Repo Layer"
        Repo["Dotfiles Monorepo"]:::repo
        BS1["setup_arch.bash"]:::script
        BS2["vm-run.sh"]:::script
        BS3["tools/zenn_push.bash"]:::script
        Linker["setup/links.sh"]:::script
    end
    click Repo "https://github.com/uliboooo/dotfiles/tree/main//"
    click BS1 "https://github.com/uliboooo/dotfiles/blob/main//setup_arhc.bash"
    click BS2 "https://github.com/uliboooo/dotfiles/blob/main//vm-run.sh"
    click BS3 "https://github.com/uliboooo/dotfiles/blob/main/tools/zenn_push.bash"
    click Linker "https://github.com/uliboooo/dotfiles/blob/main/setup/links.sh"

    GitHub --> Repo

    User -->|"run bootstrap"| BS1
    BS1 -->|"invoke package install"| PM1
    BS1 -->|"invoke linker"| Linker

    subgraph "Install Layer"
        PM1["Homebrew"]:::pm
        PM2["APT"]:::pm
        PM3["DNF"]:::pm
        PM4["Pacman"]:::pm
        PM1 & PM2 & PM3 & PM4 --> Dependencies["Dependencies Installed"]:::pm
    end
    BS1 --> PM1
    BS1 --> PM2
    BS1 --> PM3
    BS1 --> PM4
    Dependencies -->|"installed on"| OS["Operating System"]:::external

    Linker -->|"ln -s configs"| HomeDir(("Home Directory")):::fs

    subgraph "Home Directory (Target)"
        HD1["~/.config"]:::fs
        HD2["~/.*rc files"]:::fs
    end
    HomeDir --> HD1
    HomeDir --> HD2

    subgraph "Tool Consumption"
        Zsh["Zsh"]:::tool
        Neovim["Neovim"]:::tool
        Alacritty["Alacritty"]:::tool
        WezTerm["WezTerm"]:::tool
        Starship["Starship"]:::tool
        OtherCLI["Other CLI Tools"]:::tool
    end
    HD1 --> Zsh
    HD1 --> Neovim
    HD1 --> Alacritty
    HD1 --> WezTerm
    HD1 --> Starship
    HD1 --> OtherCLI
    HD2 --> Zsh

    classDef user fill:#f9f,stroke:#333,stroke-width:1px;
    classDef external fill:#bbf,stroke:#333,stroke-width:1px;
    classDef repo fill:#bfb,stroke:#333,stroke-width:1px;
    classDef script fill:#ffc,stroke:#333,stroke-width:1px;
    classDef pm fill:#fcf,stroke:#333,stroke-width:1px;
    classDef fs fill:#eef,stroke:#333,stroke-width:1px;
    classDef tool fill:#efe,stroke:#333,stroke-width:1px;
```
