# afsalz/tunavim architecture

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

- Interactive diagram: https://gitdiagram.com/afsalz/tunavim
- Repository: https://github.com/afsalz/tunavim

## Overview

TunaVim is a Neovim configuration; the main workflow is that a user starts Neovim, which loads the configuration and its plugins, then uses editor features such as completion, navigation, formatting, and project tools. Core setup lives in `init.lua`; personal and retained kickstart modules supply focused capabilities. The README documents the feature set and module layout, but no source excerpts were provided, so edges reflect only those documented relationships rather than inferred calls.

Main entry points: [`init.lua`](https://github.com/afsalz/tunavim/blob/main/init.lua) (Core configuration), [`lua/custom/plugins`](https://github.com/afsalz/tunavim/tree/main/lua/custom/plugins) (Auto-loaded modules), [`nvim-pack-lock.json`](https://github.com/afsalz/tunavim/blob/main/nvim-pack-lock.json) (Plugin lockfile), [`lua/kickstart/plugins/lint.lua`](https://github.com/afsalz/tunavim/blob/main/lua/kickstart/plugins/lint.lua) (Linting)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_startup["Startup and Plugins"]
  node_config["Core configuration<br/>[init.lua]"]
  node_plugin_manager["vim.pack management<br/>[init.lua]"]
  node_lockfile["Plugin lockfile"]
  node_custom_modules["Auto-loaded modules"]
end

subgraph group_editing["Editing Support"]
  node_lsp["LSP setup<br/>[init.lua]"]
  node_completion["Completion and snippets<br/>[init.lua]"]
  node_formatting["Formatting<br/>[init.lua]"]
  node_linting["Linting<br/>[lint.lua]"]
  node_treesitter["Treesitter parsers<br/>[init.lua]"]
  node_debugging["Debugging<br/>[debug.lua]"]
end

subgraph group_navigation["Navigation and Git"]
  node_search["Fuzzy finding<br/>[init.lua]"]
  node_explorer["Explorer and lazygit<br/>[explorer.lua]"]
  node_git["Git signs and hunks<br/>[gitsigns.lua]"]
end

subgraph group_personal["Personal Features"]
  node_keymaps["Key mappings<br/>[keymaps.lua]"]
  node_ui["Editor UI<br/>[ui.lua]"]
  node_ai["AI suggestions<br/>[ai.lua]"]
  node_web["Tailwind sorting<br/>[web.lua]"]
  node_wiki["Vimwiki notes<br/>[wiki.lua]"]
  node_terminal["Floating terminal<br/>[terminal.lua]"]
  node_markdown["Markdown support<br/>[markdown.lua]"]
end

node_user(("Neovim user"))
node_mason["Mason tools"]
node_plugins["Neovim plugins"]

node_user -->|"starts Neovim"| node_config
node_config -->|"uses"| node_plugin_manager
node_plugin_manager -->|"installs plugins"| node_plugins
node_plugin_manager -->|"tracks versions"| node_lockfile
node_config -->|"loads modules"| node_custom_modules
node_config -->|"configures"| node_lsp
node_config -->|"configures"| node_completion
node_config -->|"configures"| node_formatting
node_config -->|"configures"| node_treesitter
node_config -->|"configures"| node_search
node_config -->|"includes"| node_debugging
node_lsp -->|"installs tools"| node_mason
node_custom_modules -->|"loads"| node_explorer
node_custom_modules -->|"loads"| node_keymaps
node_custom_modules -->|"loads"| node_ui
node_custom_modules -->|"loads"| node_ai
node_custom_modules -->|"loads"| node_web
node_custom_modules -->|"loads"| node_wiki
node_custom_modules -->|"loads"| node_terminal
node_custom_modules -->|"loads"| node_markdown
node_config -->|"includes"| node_linting
node_config -->|"includes"| node_git

click node_config "https://github.com/afsalz/tunavim/blob/main/init.lua"
click node_plugin_manager "https://github.com/afsalz/tunavim/blob/main/init.lua"
click node_lockfile "https://github.com/afsalz/tunavim/blob/main/nvim-pack-lock.json"
click node_custom_modules "https://github.com/afsalz/tunavim/tree/main/lua/custom/plugins"
click node_lsp "https://github.com/afsalz/tunavim/blob/main/init.lua"
click node_completion "https://github.com/afsalz/tunavim/blob/main/init.lua"
click node_formatting "https://github.com/afsalz/tunavim/blob/main/init.lua"
click node_linting "https://github.com/afsalz/tunavim/blob/main/lua/kickstart/plugins/lint.lua"
click node_treesitter "https://github.com/afsalz/tunavim/blob/main/init.lua"
click node_debugging "https://github.com/afsalz/tunavim/blob/main/lua/kickstart/plugins/debug.lua"
click node_search "https://github.com/afsalz/tunavim/blob/main/init.lua"
click node_explorer "https://github.com/afsalz/tunavim/blob/main/lua/custom/plugins/explorer.lua"
click node_git "https://github.com/afsalz/tunavim/blob/main/lua/kickstart/plugins/gitsigns.lua"
click node_keymaps "https://github.com/afsalz/tunavim/blob/main/lua/custom/plugins/keymaps.lua"
click node_ui "https://github.com/afsalz/tunavim/blob/main/lua/custom/plugins/ui.lua"
click node_ai "https://github.com/afsalz/tunavim/blob/main/lua/custom/plugins/ai.lua"
click node_web "https://github.com/afsalz/tunavim/blob/main/lua/custom/plugins/web.lua"
click node_wiki "https://github.com/afsalz/tunavim/blob/main/lua/custom/plugins/wiki.lua"
click node_terminal "https://github.com/afsalz/tunavim/blob/main/lua/custom/plugins/terminal.lua"
click node_markdown "https://github.com/afsalz/tunavim/blob/main/lua/custom/plugins/markdown.lua"

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_config,node_plugin_manager,node_lockfile,node_custom_modules,node_user toneBlue
class node_lsp,node_completion,node_formatting,node_linting,node_treesitter,node_debugging toneAmber
class node_search,node_explorer,node_git toneMint
class node_keymaps,node_ui,node_ai,node_web,node_wiki,node_terminal,node_markdown toneRose
class node_mason,node_plugins toneIndigo
```

## Components

### Startup and Plugins

- [Core configuration](https://github.com/afsalz/tunavim/blob/main/init.lua): `init.lua`
- [vim.pack management](https://github.com/afsalz/tunavim/blob/main/init.lua): `init.lua`
- [Plugin lockfile](https://github.com/afsalz/tunavim/blob/main/nvim-pack-lock.json): `nvim-pack-lock.json`
- [Auto-loaded modules](https://github.com/afsalz/tunavim/tree/main/lua/custom/plugins): `lua/custom/plugins`

### Editing Support

- [LSP setup](https://github.com/afsalz/tunavim/blob/main/init.lua): `init.lua`
- [Completion and snippets](https://github.com/afsalz/tunavim/blob/main/init.lua): `init.lua`
- [Formatting](https://github.com/afsalz/tunavim/blob/main/init.lua): `init.lua`
- [Linting](https://github.com/afsalz/tunavim/blob/main/lua/kickstart/plugins/lint.lua): `lua/kickstart/plugins/lint.lua`
- [Treesitter parsers](https://github.com/afsalz/tunavim/blob/main/init.lua): `init.lua`
- [Debugging](https://github.com/afsalz/tunavim/blob/main/lua/kickstart/plugins/debug.lua): `lua/kickstart/plugins/debug.lua`

### Navigation and Git

- [Fuzzy finding](https://github.com/afsalz/tunavim/blob/main/init.lua): `init.lua`
- [Explorer and lazygit](https://github.com/afsalz/tunavim/blob/main/lua/custom/plugins/explorer.lua): `lua/custom/plugins/explorer.lua`
- [Git signs and hunks](https://github.com/afsalz/tunavim/blob/main/lua/kickstart/plugins/gitsigns.lua): `lua/kickstart/plugins/gitsigns.lua`

### Personal Features

- [Key mappings](https://github.com/afsalz/tunavim/blob/main/lua/custom/plugins/keymaps.lua): `lua/custom/plugins/keymaps.lua`
- [Editor UI](https://github.com/afsalz/tunavim/blob/main/lua/custom/plugins/ui.lua): `lua/custom/plugins/ui.lua`
- [AI suggestions](https://github.com/afsalz/tunavim/blob/main/lua/custom/plugins/ai.lua): `lua/custom/plugins/ai.lua`
- [Tailwind sorting](https://github.com/afsalz/tunavim/blob/main/lua/custom/plugins/web.lua): `lua/custom/plugins/web.lua`
- [Vimwiki notes](https://github.com/afsalz/tunavim/blob/main/lua/custom/plugins/wiki.lua): `lua/custom/plugins/wiki.lua`
- [Floating terminal](https://github.com/afsalz/tunavim/blob/main/lua/custom/plugins/terminal.lua): `lua/custom/plugins/terminal.lua`
- [Markdown support](https://github.com/afsalz/tunavim/blob/main/lua/custom/plugins/markdown.lua): `lua/custom/plugins/markdown.lua`

### Other components

- **Neovim user**
- **Mason tools**
- **Neovim plugins**

## Connections

- Neovim user → Core configuration: starts Neovim (evidence: `README.md`)
- Core configuration → vim.pack management: uses (evidence: `README.md`)
- vim.pack management → Neovim plugins: installs plugins (evidence: `README.md`)
- vim.pack management → Plugin lockfile: tracks versions (evidence: `README.md`)
- Core configuration → Auto-loaded modules: loads modules (evidence: `README.md`)
- Core configuration → LSP setup: configures (evidence: `README.md`)
- Core configuration → Completion and snippets: configures (evidence: `README.md`)
- Core configuration → Formatting: configures (evidence: `README.md`)
- Core configuration → Treesitter parsers: configures (evidence: `README.md`)
- Core configuration → Fuzzy finding: configures (evidence: `README.md`)
- Core configuration → Debugging: includes (evidence: `README.md`)
- LSP setup → Mason tools: installs tools (evidence: `README.md`)
- Auto-loaded modules → Explorer and lazygit: loads (evidence: `README.md`)
- Auto-loaded modules → Key mappings: loads (evidence: `README.md`)
- Auto-loaded modules → Editor UI: loads (evidence: `README.md`)
- Auto-loaded modules → AI suggestions: loads (evidence: `README.md`)
- Auto-loaded modules → Tailwind sorting: loads (evidence: `README.md`)
- Auto-loaded modules → Vimwiki notes: loads (evidence: `README.md`)
- Auto-loaded modules → Floating terminal: loads (evidence: `README.md`)
- Auto-loaded modules → Markdown support: loads (evidence: `README.md`)
- Core configuration → Linting: includes (evidence: `README.md`)
- Core configuration → Git signs and hunks: includes (evidence: `README.md`)
