# ikgron/dotfiles architecture

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

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

## Overview

This repository is a personal macOS/Linux dotfiles and workstation-setup project. The documented workflow starts with downloading the repository, then runs shared symlink setup and platform-specific installers; the resulting configurations cover shell, editor, terminal, and desktop tools. The README documents the setup relationships, but no source excerpts were provided, so internal script behavior beyond those statements is not inferred. Some README paths are absent from the supplied tree and are omitted.

Main entry points: [`scripts/bootstrap.sh`](https://github.com/ikgron/dotfiles/blob/main/scripts/bootstrap.sh) (Shared bootstrap), [`scripts/bootstrap-mac.sh`](https://github.com/ikgron/dotfiles/blob/main/scripts/bootstrap-mac.sh) (macOS bootstrap), [`scripts/bootstrap-linux.sh`](https://github.com/ikgron/dotfiles/blob/main/scripts/bootstrap-linux.sh) (Linux bootstrap), [`macos/install.sh`](https://github.com/ikgron/dotfiles/blob/main/macos/install.sh) (macOS installer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_setup["Setup workflow"]
  node_remote["Remote installer<br/>[remote-install.sh]"]
  node_bootstrap["Shared bootstrap<br/>[bootstrap.sh]"]
  node_uninstall["Uninstaller<br/>[uninstall.sh]"]
end

subgraph group_macos["macOS setup"]
  node_macinstall["macOS installer<br/>[install.sh]"]
  node_macbootstrap["macOS bootstrap<br/>[bootstrap-mac.sh]"]
  node_macdefaults["macOS defaults<br/>[defaults.sh]"]
  node_packages["Homebrew packages"]
end

subgraph group_userfiles["User configurations"]
  node_shell["Shell dotfiles"]
  node_vim["Vim configuration<br/>[.vim]"]
  node_appconfigs["App configurations"]
  node_vscodium["VSCodium settings<br/>[settings.json]"]
  node_extensions["VSCodium extensions<br/>[extensions.sh]"]
end

subgraph group_platform["Platform configurations"]
  node_linuxbootstrap["Linux bootstrap<br/>[bootstrap-linux.sh]"]
  node_linuxinstall["Linux installer<br/>[install.sh]"]
  node_linuxdesktop["Linux desktop settings"]
  node_linuxsystem["Linux system settings"]
end

node_user(("Workstation user"))

node_user -->|"runs download"| node_remote
node_user -->|"runs setup"| node_bootstrap
node_user -->|"runs installer"| node_macinstall
node_user -->|"runs setup"| node_macbootstrap
node_bootstrap -->|"symlinks dotfiles"| node_shell
node_bootstrap -->|"symlinks configs"| node_appconfigs
node_bootstrap -->|"prompts Git setup"| node_user
node_macinstall -->|"installs packages"| node_packages
node_macbootstrap -->|"symlinks settings"| node_vscodium
node_macbootstrap -->|"installs extensions"| node_extensions
node_macbootstrap -->|"runs defaults"| node_macdefaults
node_user -->|"runs setup"| node_linuxbootstrap
node_linuxbootstrap -->|"symlinks settings"| node_linuxdesktop
node_linuxbootstrap -->|"links system settings"| node_linuxsystem
node_user -->|"runs removal"| node_uninstall

click node_remote "https://github.com/ikgron/dotfiles/blob/main/scripts/remote-install.sh"
click node_bootstrap "https://github.com/ikgron/dotfiles/blob/main/scripts/bootstrap.sh"
click node_uninstall "https://github.com/ikgron/dotfiles/blob/main/scripts/uninstall.sh"
click node_macinstall "https://github.com/ikgron/dotfiles/blob/main/macos/install.sh"
click node_macbootstrap "https://github.com/ikgron/dotfiles/blob/main/scripts/bootstrap-mac.sh"
click node_macdefaults "https://github.com/ikgron/dotfiles/blob/main/macos/defaults.sh"
click node_packages "https://github.com/ikgron/dotfiles/blob/main/macos/Brewfile"
click node_shell "https://github.com/ikgron/dotfiles/tree/main/home"
click node_vim "https://github.com/ikgron/dotfiles/tree/main/home/.vim"
click node_appconfigs "https://github.com/ikgron/dotfiles/tree/main/config"
click node_vscodium "https://github.com/ikgron/dotfiles/blob/main/vscodium/settings.json"
click node_extensions "https://github.com/ikgron/dotfiles/blob/main/vscodium/extensions.sh"
click node_linuxbootstrap "https://github.com/ikgron/dotfiles/blob/main/scripts/bootstrap-linux.sh"
click node_linuxinstall "https://github.com/ikgron/dotfiles/blob/main/linux/install.sh"
click node_linuxdesktop "https://github.com/ikgron/dotfiles/tree/main/linux/config"
click node_linuxsystem "https://github.com/ikgron/dotfiles/tree/main/linux/system"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_remote,node_bootstrap,node_uninstall,node_user toneBlue
class node_macinstall,node_macbootstrap,node_macdefaults,node_packages toneAmber
class node_shell,node_vim,node_appconfigs,node_vscodium,node_extensions toneMint
class node_linuxbootstrap,node_linuxinstall,node_linuxdesktop,node_linuxsystem toneRose
```

## Components

### Setup workflow

- [Remote installer](https://github.com/ikgron/dotfiles/blob/main/scripts/remote-install.sh): `scripts/remote-install.sh`
- [Shared bootstrap](https://github.com/ikgron/dotfiles/blob/main/scripts/bootstrap.sh): `scripts/bootstrap.sh`
- [Uninstaller](https://github.com/ikgron/dotfiles/blob/main/scripts/uninstall.sh): `scripts/uninstall.sh`

### macOS setup

- [macOS installer](https://github.com/ikgron/dotfiles/blob/main/macos/install.sh): `macos/install.sh`
- [macOS bootstrap](https://github.com/ikgron/dotfiles/blob/main/scripts/bootstrap-mac.sh): `scripts/bootstrap-mac.sh`
- [macOS defaults](https://github.com/ikgron/dotfiles/blob/main/macos/defaults.sh): `macos/defaults.sh`
- [Homebrew packages](https://github.com/ikgron/dotfiles/blob/main/macos/Brewfile): `macos/Brewfile`

### User configurations

- [Shell dotfiles](https://github.com/ikgron/dotfiles/tree/main/home): `home`
- [Vim configuration](https://github.com/ikgron/dotfiles/tree/main/home/.vim): `home/.vim`
- [App configurations](https://github.com/ikgron/dotfiles/tree/main/config): `config`
- [VSCodium settings](https://github.com/ikgron/dotfiles/blob/main/vscodium/settings.json): `vscodium/settings.json`
- [VSCodium extensions](https://github.com/ikgron/dotfiles/blob/main/vscodium/extensions.sh): `vscodium/extensions.sh`

### Platform configurations

- [Linux bootstrap](https://github.com/ikgron/dotfiles/blob/main/scripts/bootstrap-linux.sh): `scripts/bootstrap-linux.sh`
- [Linux installer](https://github.com/ikgron/dotfiles/blob/main/linux/install.sh): `linux/install.sh`
- [Linux desktop settings](https://github.com/ikgron/dotfiles/tree/main/linux/config): `linux/config`
- [Linux system settings](https://github.com/ikgron/dotfiles/tree/main/linux/system): `linux/system`

### Other components

- **Workstation user**

## Connections

- Workstation user → Remote installer: runs download (evidence: `README.md`)
- Workstation user → Shared bootstrap: runs setup (evidence: `README.md`)
- Workstation user → macOS installer: runs installer (evidence: `README.md`)
- Workstation user → macOS bootstrap: runs setup (evidence: `README.md`)
- Shared bootstrap → Shell dotfiles: symlinks dotfiles (evidence: `README.md`)
- Shared bootstrap → App configurations: symlinks configs (evidence: `README.md`)
- Shared bootstrap → Workstation user: prompts Git setup (evidence: `README.md`)
- macOS installer → Homebrew packages: installs packages (evidence: `README.md`)
- macOS bootstrap → VSCodium settings: symlinks settings (evidence: `README.md`)
- macOS bootstrap → VSCodium extensions: installs extensions (evidence: `README.md`)
- macOS bootstrap → macOS defaults: runs defaults (evidence: `README.md`)
- Workstation user → Linux bootstrap: runs setup (evidence: `README.md`)
- Linux bootstrap → Linux desktop settings: symlinks settings (evidence: `README.md`)
- Linux bootstrap → Linux system settings: links system settings (evidence: `README.md`)
- Workstation user → Uninstaller: runs removal (evidence: `README.md`)
