# myposty/dotfiles architecture

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

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

## Overview

This repository packages a cross-platform developer environment: installation links the configurations, then users work in Neovim with a terminal such as WezTerm. The README documents the editor’s shortcuts, sessions, explorer, Git, Claude, images, Markdown, and update behavior. Paths identify the corresponding configuration files; source excerpts were unavailable, so relationships below rely on README statements rather than inspected call sites.

Main entry points: [`nvim/init.lua`](https://github.com/myposty/dotfiles/blob/main/nvim/init.lua) (Neovim configuration), [`install.sh`](https://github.com/myposty/dotfiles/blob/main/install.sh) (Unix installer), [`install.ps1`](https://github.com/myposty/dotfiles/blob/main/install.ps1) (Windows installer), [`nvim/lua/config/updates.lua`](https://github.com/myposty/dotfiles/blob/main/nvim/lua/config/updates.lua) (Update checker)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_setup["Installation"]
  node_install_unix["Unix installer<br/>[install.sh]"]
  node_install_windows["Windows installer<br/>[install.ps1]"]
end

subgraph group_editor["Neovim Editing"]
  node_nvim["Neovim configuration<br/>[init.lua]"]
  node_keymaps["Key mappings<br/>[keymaps.lua]"]
end

subgraph group_editor_ui["Neovim Features"]
  node_shortcuts["Shortcut finder<br/>[shortcuts.lua]"]
  node_menu["Command menu<br/>[menu.lua]"]
  node_explorer["File explorer<br/>[explorer.lua]"]
  node_sessions["Sessions<br/>[sessions.lua]"]
  node_scm["Git changes<br/>[scm.lua]"]
  node_markdown["Markdown preview<br/>[markdown.lua]"]
  node_images["Image display<br/>[images.lua]"]
  node_scrollbar["Panel scrollbar<br/>[scrollbar.lua]"]
  node_claude["Claude integration<br/>[claude.lua]"]
  node_updates["Update checker<br/>[updates.lua]"]
end

subgraph group_terminals["Terminal Integration"]
  node_wezterm["WezTerm configuration<br/>[wezterm.lua]"]
  node_wezterm_themes["Terminal themes<br/>[themes.lua]"]
  node_windows_terminal["Windows Terminal keys<br/>[nvim-keys.json]"]
end

node_user(("User"))
node_github(("GitHub"))
node_terminal_app(("Terminal application"))

node_user -->|"runs on Unix"| node_install_unix
node_user -->|"runs on Windows"| node_install_windows
node_install_unix -->|"links config"| node_nvim
node_install_unix -->|"links config"| node_wezterm
node_install_windows -->|"links config"| node_nvim
node_install_windows -->|"merges keys"| node_windows_terminal
node_user -->|"opens editor"| node_nvim
node_user -->|"finds shortcuts"| node_shortcuts
node_user -->|"opens menu"| node_menu
node_user -->|"browses files"| node_explorer
node_user -->|"resumes sessions"| node_sessions
node_user -->|"views changes"| node_scm
node_user -->|"previews Markdown"| node_markdown
node_user -->|"pastes images"| node_images
node_user -->|"scrolls panels"| node_scrollbar
node_user -->|"opens Claude"| node_claude
node_nvim -->|"checks updates"| node_updates
node_updates -->|"checks commits"| node_github
node_user -->|"uses terminal"| node_wezterm
node_user -->|"uses terminal"| node_terminal_app

click node_install_unix "https://github.com/myposty/dotfiles/blob/main/install.sh"
click node_install_windows "https://github.com/myposty/dotfiles/blob/main/install.ps1"
click node_nvim "https://github.com/myposty/dotfiles/blob/main/nvim/init.lua"
click node_keymaps "https://github.com/myposty/dotfiles/blob/main/nvim/lua/config/keymaps.lua"
click node_shortcuts "https://github.com/myposty/dotfiles/blob/main/nvim/lua/config/shortcuts.lua"
click node_menu "https://github.com/myposty/dotfiles/blob/main/nvim/lua/config/menu.lua"
click node_explorer "https://github.com/myposty/dotfiles/blob/main/nvim/lua/config/explorer.lua"
click node_sessions "https://github.com/myposty/dotfiles/blob/main/nvim/lua/config/sessions.lua"
click node_scm "https://github.com/myposty/dotfiles/blob/main/nvim/lua/config/scm.lua"
click node_markdown "https://github.com/myposty/dotfiles/blob/main/nvim/lua/config/markdown.lua"
click node_images "https://github.com/myposty/dotfiles/blob/main/nvim/lua/config/images.lua"
click node_scrollbar "https://github.com/myposty/dotfiles/blob/main/nvim/lua/config/scrollbar.lua"
click node_claude "https://github.com/myposty/dotfiles/blob/main/nvim/lua/config/claude.lua"
click node_updates "https://github.com/myposty/dotfiles/blob/main/nvim/lua/config/updates.lua"
click node_wezterm "https://github.com/myposty/dotfiles/blob/main/wezterm/wezterm.lua"
click node_wezterm_themes "https://github.com/myposty/dotfiles/blob/main/wezterm/themes.lua"
click node_windows_terminal "https://github.com/myposty/dotfiles/blob/main/windows-terminal/nvim-keys.json"

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_install_unix,node_install_windows,node_user toneBlue
class node_nvim,node_keymaps toneAmber
class node_shortcuts,node_menu,node_explorer,node_sessions,node_scm,node_markdown,node_images,node_scrollbar,node_claude,node_updates toneMint
class node_wezterm,node_wezterm_themes,node_windows_terminal toneRose
class node_github,node_terminal_app toneIndigo
```

## Components

### Installation

- [Unix installer](https://github.com/myposty/dotfiles/blob/main/install.sh): `install.sh`
- [Windows installer](https://github.com/myposty/dotfiles/blob/main/install.ps1): `install.ps1`

### Neovim Editing

- [Neovim configuration](https://github.com/myposty/dotfiles/blob/main/nvim/init.lua): `nvim/init.lua`
- [Key mappings](https://github.com/myposty/dotfiles/blob/main/nvim/lua/config/keymaps.lua): `nvim/lua/config/keymaps.lua`

### Neovim Features

- [Shortcut finder](https://github.com/myposty/dotfiles/blob/main/nvim/lua/config/shortcuts.lua): `nvim/lua/config/shortcuts.lua`
- [Command menu](https://github.com/myposty/dotfiles/blob/main/nvim/lua/config/menu.lua): `nvim/lua/config/menu.lua`
- [File explorer](https://github.com/myposty/dotfiles/blob/main/nvim/lua/config/explorer.lua): `nvim/lua/config/explorer.lua`
- [Sessions](https://github.com/myposty/dotfiles/blob/main/nvim/lua/config/sessions.lua): `nvim/lua/config/sessions.lua`
- [Git changes](https://github.com/myposty/dotfiles/blob/main/nvim/lua/config/scm.lua): `nvim/lua/config/scm.lua`
- [Markdown preview](https://github.com/myposty/dotfiles/blob/main/nvim/lua/config/markdown.lua): `nvim/lua/config/markdown.lua`
- [Image display](https://github.com/myposty/dotfiles/blob/main/nvim/lua/config/images.lua): `nvim/lua/config/images.lua`
- [Panel scrollbar](https://github.com/myposty/dotfiles/blob/main/nvim/lua/config/scrollbar.lua): `nvim/lua/config/scrollbar.lua`
- [Claude integration](https://github.com/myposty/dotfiles/blob/main/nvim/lua/config/claude.lua): `nvim/lua/config/claude.lua`
- [Update checker](https://github.com/myposty/dotfiles/blob/main/nvim/lua/config/updates.lua): `nvim/lua/config/updates.lua`

### Terminal Integration

- [WezTerm configuration](https://github.com/myposty/dotfiles/blob/main/wezterm/wezterm.lua): `wezterm/wezterm.lua`
- [Terminal themes](https://github.com/myposty/dotfiles/blob/main/wezterm/themes.lua): `wezterm/themes.lua`
- [Windows Terminal keys](https://github.com/myposty/dotfiles/blob/main/windows-terminal/nvim-keys.json): `windows-terminal/nvim-keys.json`

### Other components

- **User**
- **GitHub**
- **Terminal application**

## Connections

- User → Unix installer: runs on Unix (evidence: `README.md`)
- User → Windows installer: runs on Windows (evidence: `README.md`)
- Unix installer → Neovim configuration: links config (evidence: `README.md`)
- Unix installer → WezTerm configuration: links config (evidence: `README.md`)
- Windows installer → Neovim configuration: links config (evidence: `README.md`)
- Windows installer → Windows Terminal keys: merges keys (evidence: `README.md`)
- User → Neovim configuration: opens editor (evidence: `README.md`)
- User → Shortcut finder: finds shortcuts (evidence: `README.md`)
- User → Command menu: opens menu (evidence: `README.md`)
- User → File explorer: browses files (evidence: `README.md`)
- User → Sessions: resumes sessions (evidence: `README.md`)
- User → Git changes: views changes (evidence: `README.md`)
- User → Markdown preview: previews Markdown (evidence: `README.md`)
- User → Image display: pastes images (evidence: `README.md`)
- User → Panel scrollbar: scrolls panels (evidence: `README.md`)
- User → Claude integration: opens Claude (evidence: `README.md`)
- Neovim configuration → Update checker: checks updates (evidence: `README.md`)
- Update checker → GitHub: checks commits (evidence: `README.md`)
- User → WezTerm configuration: uses terminal (evidence: `README.md`)
- User → Terminal application: uses terminal (evidence: `README.md`)
