# coreymschafer/dotfiles architecture

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

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

## Overview

This repository provisions a personalized development environment across macOS, Ubuntu/WSL, and Windows. The documented macOS workflow starts with `install.sh`, which links configuration, applies macOS settings, installs software, and configures VS Code; separate platform installers cover Linux and Windows. The graph also preserves shell, editor, terminal, font, and AI-skill setup capabilities described in the README. No source excerpts were provided, so relationships are limited to those explicitly documented there.

Main entry points: [`install.sh`](https://github.com/coreymschafer/dotfiles/blob/master/install.sh) (macOS installer), [`brew.sh`](https://github.com/coreymschafer/dotfiles/blob/master/brew.sh) (Homebrew setup), [`ubuntu/install.sh`](https://github.com/coreymschafer/dotfiles/blob/master/ubuntu/install.sh) (Ubuntu installer), [`windows/install.ps1`](https://github.com/coreymschafer/dotfiles/blob/master/windows/install.ps1) (Windows installer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_mac["macOS Setup"]
  node_mac_install["macOS installer<br/>[install.sh]"]
  node_mac_settings["System settings<br/>[macOS.sh]"]
  node_shared_helpers["Install helpers<br/>[helpers.sh]"]
end

subgraph group_config["User Configuration"]
  node_shell_config["Shell dotfiles<br/>[.zshrc]"]
  node_shell_prompt["Shell prompt<br/>[.zprompt]"]
  node_shell_aliases["Shell aliases<br/>[.aliases]"]
  node_app_settings["App settings"]
end

subgraph group_software["Software Installation"]
  node_homebrew_setup["Homebrew setup<br/>[brew.sh]"]
  node_package_list["Package manifest<br/>[packages.txt]"]
  node_app_list["App manifest<br/>[apps.txt]"]
  node_font_list["Font manifest<br/>[fonts.txt]"]
  node_font_files["Local fonts"]
  node_vscode_setup["VS Code setup<br/>[vscode.sh]"]
  node_extension_list["Extension manifest"]
  node_skill_list["AI skill manifest<br/>[skills_ai.txt]"]
end

subgraph group_platforms["Other Platforms"]
  node_ubuntu_setup["Ubuntu installer<br/>[install.sh]"]
  node_apt_list["APT manifest<br/>[apt.txt]"]
  node_windows_setup["Windows installer<br/>[install.ps1]"]
  node_winget_list["Winget manifest<br/>[winget.txt]"]
  node_windows_settings["Windows settings"]
end

node_user(("Environment user"))

node_user -->|"runs"| node_mac_install
node_mac_install -->|"symlinks"| node_shell_config
node_mac_install -->|"symlinks"| node_shell_prompt
node_mac_install -->|"symlinks"| node_shell_aliases
node_mac_install -->|"symlinks"| node_app_settings
node_mac_install -->|"runs"| node_mac_settings
node_mac_install -->|"runs"| node_homebrew_setup
node_mac_install -->|"runs"| node_vscode_setup
node_homebrew_setup -->|"installs from"| node_package_list
node_homebrew_setup -->|"installs from"| node_app_list
node_homebrew_setup -->|"installs from"| node_font_list
node_homebrew_setup -->|"installs"| node_font_files
node_homebrew_setup -->|"installs"| node_skill_list
node_vscode_setup -->|"installs from"| node_extension_list
node_user -->|"runs"| node_ubuntu_setup
node_ubuntu_setup -->|"installs from"| node_apt_list
node_user -->|"runs"| node_windows_setup
node_windows_setup -->|"installs from"| node_winget_list
node_windows_setup -->|"configures"| node_windows_settings
node_mac_settings -.->|"uses"| node_shared_helpers
node_ubuntu_setup -.->|"uses"| node_shared_helpers

click node_mac_install "https://github.com/coreymschafer/dotfiles/blob/master/install.sh"
click node_mac_settings "https://github.com/coreymschafer/dotfiles/blob/master/macOS.sh"
click node_shared_helpers "https://github.com/coreymschafer/dotfiles/blob/master/helpers.sh"
click node_shell_config "https://github.com/coreymschafer/dotfiles/blob/master/.zshrc"
click node_shell_prompt "https://github.com/coreymschafer/dotfiles/blob/master/.zprompt"
click node_shell_aliases "https://github.com/coreymschafer/dotfiles/blob/master/.aliases"
click node_app_settings "https://github.com/coreymschafer/dotfiles/tree/master/settings"
click node_homebrew_setup "https://github.com/coreymschafer/dotfiles/blob/master/brew.sh"
click node_package_list "https://github.com/coreymschafer/dotfiles/blob/master/packages.txt"
click node_app_list "https://github.com/coreymschafer/dotfiles/blob/master/apps.txt"
click node_font_list "https://github.com/coreymschafer/dotfiles/blob/master/fonts.txt"
click node_font_files "https://github.com/coreymschafer/dotfiles/tree/master/fonts"
click node_vscode_setup "https://github.com/coreymschafer/dotfiles/blob/master/vscode.sh"
click node_extension_list "https://github.com/coreymschafer/dotfiles/blob/master/vscode-extensions.txt"
click node_skill_list "https://github.com/coreymschafer/dotfiles/blob/master/skills_ai.txt"
click node_ubuntu_setup "https://github.com/coreymschafer/dotfiles/blob/master/ubuntu/install.sh"
click node_apt_list "https://github.com/coreymschafer/dotfiles/blob/master/ubuntu/apt.txt"
click node_windows_setup "https://github.com/coreymschafer/dotfiles/blob/master/windows/install.ps1"
click node_winget_list "https://github.com/coreymschafer/dotfiles/blob/master/windows/winget.txt"
click node_windows_settings "https://github.com/coreymschafer/dotfiles/tree/master/windows/settings"

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_mac_install,node_mac_settings,node_shared_helpers,node_user toneBlue
class node_shell_config,node_shell_prompt,node_shell_aliases,node_app_settings toneAmber
class node_homebrew_setup,node_package_list,node_app_list,node_font_list,node_font_files,node_vscode_setup,node_extension_list,node_skill_list toneMint
class node_ubuntu_setup,node_apt_list,node_windows_setup,node_winget_list,node_windows_settings toneRose
```

## Components

### macOS Setup

- [macOS installer](https://github.com/coreymschafer/dotfiles/blob/master/install.sh): `install.sh`
- [System settings](https://github.com/coreymschafer/dotfiles/blob/master/macOS.sh): `macOS.sh`
- [Install helpers](https://github.com/coreymschafer/dotfiles/blob/master/helpers.sh): `helpers.sh`

### User Configuration

- [Shell dotfiles](https://github.com/coreymschafer/dotfiles/blob/master/.zshrc): `.zshrc`
- [Shell prompt](https://github.com/coreymschafer/dotfiles/blob/master/.zprompt): `.zprompt`
- [Shell aliases](https://github.com/coreymschafer/dotfiles/blob/master/.aliases): `.aliases`
- [App settings](https://github.com/coreymschafer/dotfiles/tree/master/settings): `settings`

### Software Installation

- [Homebrew setup](https://github.com/coreymschafer/dotfiles/blob/master/brew.sh): `brew.sh`
- [Package manifest](https://github.com/coreymschafer/dotfiles/blob/master/packages.txt): `packages.txt`
- [App manifest](https://github.com/coreymschafer/dotfiles/blob/master/apps.txt): `apps.txt`
- [Font manifest](https://github.com/coreymschafer/dotfiles/blob/master/fonts.txt): `fonts.txt`
- [Local fonts](https://github.com/coreymschafer/dotfiles/tree/master/fonts): `fonts`
- [VS Code setup](https://github.com/coreymschafer/dotfiles/blob/master/vscode.sh): `vscode.sh`
- [Extension manifest](https://github.com/coreymschafer/dotfiles/blob/master/vscode-extensions.txt): `vscode-extensions.txt`
- [AI skill manifest](https://github.com/coreymschafer/dotfiles/blob/master/skills_ai.txt): `skills_ai.txt`

### Other Platforms

- [Ubuntu installer](https://github.com/coreymschafer/dotfiles/blob/master/ubuntu/install.sh): `ubuntu/install.sh`
- [APT manifest](https://github.com/coreymschafer/dotfiles/blob/master/ubuntu/apt.txt): `ubuntu/apt.txt`
- [Windows installer](https://github.com/coreymschafer/dotfiles/blob/master/windows/install.ps1): `windows/install.ps1`
- [Winget manifest](https://github.com/coreymschafer/dotfiles/blob/master/windows/winget.txt): `windows/winget.txt`
- [Windows settings](https://github.com/coreymschafer/dotfiles/tree/master/windows/settings): `windows/settings`

### Other components

- **Environment user**

## Connections

- Environment user → macOS installer: runs (evidence: `README.md`)
- macOS installer → Shell dotfiles: symlinks (evidence: `README.md`)
- macOS installer → Shell prompt: symlinks (evidence: `README.md`)
- macOS installer → Shell aliases: symlinks (evidence: `README.md`)
- macOS installer → App settings: symlinks (evidence: `README.md`)
- macOS installer → System settings: runs (evidence: `README.md`)
- macOS installer → Homebrew setup: runs (evidence: `README.md`)
- macOS installer → VS Code setup: runs (evidence: `README.md`)
- Homebrew setup → Package manifest: installs from (evidence: `README.md`)
- Homebrew setup → App manifest: installs from (evidence: `README.md`)
- Homebrew setup → Font manifest: installs from (evidence: `README.md`)
- Homebrew setup → Local fonts: installs (evidence: `README.md`)
- Homebrew setup → AI skill manifest: installs (evidence: `README.md`)
- VS Code setup → Extension manifest: installs from (evidence: `README.md`)
- Environment user → Ubuntu installer: runs (evidence: `README.md`)
- Ubuntu installer → APT manifest: installs from (evidence: `README.md`)
- Environment user → Windows installer: runs (evidence: `README.md`)
- Windows installer → Winget manifest: installs from (evidence: `README.md`)
- Windows installer → Windows settings: configures (evidence: `README.md`)
- System settings → Install helpers: uses
- Ubuntu installer → Install helpers: uses
