# ivanaguilarjr/nvimconfig architecture

> Architecture diagram of the GitHub repository ivanaguilarjr/nvimconfig, 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/ivanaguilarjr/nvimconfig
- Repository: https://github.com/ivanaguilarjr/nvimconfig

## Overview

This repository is a personal Neovim configuration written in Lua and managed with Lazy.nvim. Its user-facing purpose is to provide a customized editing environment; the tree shows core settings and keymaps alongside plugin configurations for language tooling, navigation, appearance, and editing workflow. No source excerpts were provided, so the graph preserves these identifiable components but omits implementation relationships that cannot be verified. The README documents Lazy.nvim management, but not the configuration’s specific runtime sequence.

Main entry points: [`init.lua`](https://github.com/ivanaguilarjr/nvimconfig/blob/main/init.lua) (Config Entry), [`lua/ivan/lazy.lua`](https://github.com/ivanaguilarjr/nvimconfig/blob/main/lua/ivan/lazy.lua) (Lazy Setup)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_startup["Configuration"]
  node_entry["Config Entry<br/>[init.lua]"]
  node_lazy["Lazy Setup<br/>[lazy.lua]"]
  node_plugin_index["Plugin Index<br/>[init.lua]"]
end

subgraph group_core["Editor Core"]
  node_core_init["Core Setup<br/>[init.lua]"]
  node_options["Editor Options<br/>[options.lua]"]
  node_keymaps["Keymaps<br/>[keymaps.lua]"]
end

subgraph group_language["Language Tooling"]
  node_lspconfig["LSP Configuration<br/>[lspconfig.lua]"]
  node_mason["Mason<br/>[mason.lua]"]
  node_completion["Completion<br/>[nvim-cmp.lua]"]
  node_treesitter["Treesitter<br/>[treesitter.lua]"]
  node_formatting["Formatting<br/>[formatting.lua]"]
  node_linting["Linting<br/>[linting.lua]"]
end

subgraph group_interface["Navigation &amp; UI"]
  node_telescope["Telescope<br/>[telescope.lua]"]
  node_tree["File Tree<br/>[nvim-tree.lua]"]
  node_bufferline["Buffer Line<br/>[bufferline.lua]"]
  node_lualine["Status Line<br/>[lualine.lua]"]
  node_alpha["Dashboard<br/>[alpha.lua]"]
  node_whichkey["Key Discovery<br/>[which-key.lua]"]
  node_dressing["UI Prompts<br/>[dressing.lua]"]
  node_trouble["Diagnostics View<br/>[trouble.lua]"]
  node_colorscheme["Colorscheme<br/>[colorscheme.lua]"]
end

subgraph group_editing["Editing Workflow"]
  node_gitsigns["Git Signs<br/>[gitsigns.lua]"]
  node_lazygit["LazyGit<br/>[lazygit.lua]"]
  node_session["Sessions<br/>[auto-session.lua]"]
  node_autopairs["Auto Pairs<br/>[autopairs.lua]"]
  node_comment["Commenting<br/>[comment.lua]"]
  node_indent["Indent Guides"]
  node_rainbow["Rainbow Delimiters<br/>[rainbow.lua]"]
  node_substitute["Substitution<br/>[substitute.lua]"]
  node_surround["Surround Editing<br/>[surround.lua]"]
  node_todo["TODO Comments<br/>[todo-comments.lua]"]
  node_maximizer["Window Maximizer<br/>[vim-maximizer.lua]"]
end

node_user(("Editor User"))
node_nvim["Neovim"]

node_user -->|"edits with"| node_nvim
node_entry -.->|"configures"| node_nvim
node_lazy -->|"managed by"| node_nvim

click node_entry "https://github.com/ivanaguilarjr/nvimconfig/blob/main/init.lua"
click node_lazy "https://github.com/ivanaguilarjr/nvimconfig/blob/main/lua/ivan/lazy.lua"
click node_plugin_index "https://github.com/ivanaguilarjr/nvimconfig/blob/main/lua/ivan/plugins/init.lua"
click node_core_init "https://github.com/ivanaguilarjr/nvimconfig/blob/main/lua/ivan/core/init.lua"
click node_options "https://github.com/ivanaguilarjr/nvimconfig/blob/main/lua/ivan/core/options.lua"
click node_keymaps "https://github.com/ivanaguilarjr/nvimconfig/blob/main/lua/ivan/core/keymaps.lua"
click node_lspconfig "https://github.com/ivanaguilarjr/nvimconfig/blob/main/lua/ivan/plugins/lsp/lspconfig.lua"
click node_mason "https://github.com/ivanaguilarjr/nvimconfig/blob/main/lua/ivan/plugins/lsp/mason.lua"
click node_completion "https://github.com/ivanaguilarjr/nvimconfig/blob/main/lua/ivan/plugins/nvim-cmp.lua"
click node_treesitter "https://github.com/ivanaguilarjr/nvimconfig/blob/main/lua/ivan/plugins/treesitter.lua"
click node_formatting "https://github.com/ivanaguilarjr/nvimconfig/blob/main/lua/ivan/plugins/formatting.lua"
click node_linting "https://github.com/ivanaguilarjr/nvimconfig/blob/main/lua/ivan/plugins/linting.lua"
click node_telescope "https://github.com/ivanaguilarjr/nvimconfig/blob/main/lua/ivan/plugins/telescope.lua"
click node_tree "https://github.com/ivanaguilarjr/nvimconfig/blob/main/lua/ivan/plugins/nvim-tree.lua"
click node_bufferline "https://github.com/ivanaguilarjr/nvimconfig/blob/main/lua/ivan/plugins/bufferline.lua"
click node_lualine "https://github.com/ivanaguilarjr/nvimconfig/blob/main/lua/ivan/plugins/lualine.lua"
click node_alpha "https://github.com/ivanaguilarjr/nvimconfig/blob/main/lua/ivan/plugins/alpha.lua"
click node_whichkey "https://github.com/ivanaguilarjr/nvimconfig/blob/main/lua/ivan/plugins/which-key.lua"
click node_dressing "https://github.com/ivanaguilarjr/nvimconfig/blob/main/lua/ivan/plugins/dressing.lua"
click node_trouble "https://github.com/ivanaguilarjr/nvimconfig/blob/main/lua/ivan/plugins/trouble.lua"
click node_colorscheme "https://github.com/ivanaguilarjr/nvimconfig/blob/main/lua/ivan/plugins/colorscheme.lua"
click node_gitsigns "https://github.com/ivanaguilarjr/nvimconfig/blob/main/lua/ivan/plugins/gitsigns.lua"
click node_lazygit "https://github.com/ivanaguilarjr/nvimconfig/blob/main/lua/ivan/plugins/lazygit.lua"
click node_session "https://github.com/ivanaguilarjr/nvimconfig/blob/main/lua/ivan/plugins/auto-session.lua"
click node_autopairs "https://github.com/ivanaguilarjr/nvimconfig/blob/main/lua/ivan/plugins/autopairs.lua"
click node_comment "https://github.com/ivanaguilarjr/nvimconfig/blob/main/lua/ivan/plugins/comment.lua"
click node_indent "https://github.com/ivanaguilarjr/nvimconfig/blob/main/lua/ivan/plugins/indent-blankline.lua"
click node_rainbow "https://github.com/ivanaguilarjr/nvimconfig/blob/main/lua/ivan/plugins/rainbow.lua"
click node_substitute "https://github.com/ivanaguilarjr/nvimconfig/blob/main/lua/ivan/plugins/substitute.lua"
click node_surround "https://github.com/ivanaguilarjr/nvimconfig/blob/main/lua/ivan/plugins/surround.lua"
click node_todo "https://github.com/ivanaguilarjr/nvimconfig/blob/main/lua/ivan/plugins/todo-comments.lua"
click node_maximizer "https://github.com/ivanaguilarjr/nvimconfig/blob/main/lua/ivan/plugins/vim-maximizer.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_entry,node_lazy,node_plugin_index,node_user toneBlue
class node_core_init,node_options,node_keymaps toneAmber
class node_lspconfig,node_mason,node_completion,node_treesitter,node_formatting,node_linting toneMint
class node_telescope,node_tree,node_bufferline,node_lualine,node_alpha,node_whichkey,node_dressing,node_trouble,node_colorscheme toneRose
class node_gitsigns,node_lazygit,node_session,node_autopairs,node_comment,node_indent,node_rainbow,node_substitute,node_surround,node_todo,node_maximizer,node_nvim toneIndigo
```

## Components

### Configuration

- [Config Entry](https://github.com/ivanaguilarjr/nvimconfig/blob/main/init.lua): `init.lua`
- [Lazy Setup](https://github.com/ivanaguilarjr/nvimconfig/blob/main/lua/ivan/lazy.lua): `lua/ivan/lazy.lua`
- [Plugin Index](https://github.com/ivanaguilarjr/nvimconfig/blob/main/lua/ivan/plugins/init.lua): `lua/ivan/plugins/init.lua`

### Editor Core

- [Core Setup](https://github.com/ivanaguilarjr/nvimconfig/blob/main/lua/ivan/core/init.lua): `lua/ivan/core/init.lua`
- [Editor Options](https://github.com/ivanaguilarjr/nvimconfig/blob/main/lua/ivan/core/options.lua): `lua/ivan/core/options.lua`
- [Keymaps](https://github.com/ivanaguilarjr/nvimconfig/blob/main/lua/ivan/core/keymaps.lua): `lua/ivan/core/keymaps.lua`

### Language Tooling

- [LSP Configuration](https://github.com/ivanaguilarjr/nvimconfig/blob/main/lua/ivan/plugins/lsp/lspconfig.lua): `lua/ivan/plugins/lsp/lspconfig.lua`
- [Mason](https://github.com/ivanaguilarjr/nvimconfig/blob/main/lua/ivan/plugins/lsp/mason.lua): `lua/ivan/plugins/lsp/mason.lua`
- [Completion](https://github.com/ivanaguilarjr/nvimconfig/blob/main/lua/ivan/plugins/nvim-cmp.lua): `lua/ivan/plugins/nvim-cmp.lua`
- [Treesitter](https://github.com/ivanaguilarjr/nvimconfig/blob/main/lua/ivan/plugins/treesitter.lua): `lua/ivan/plugins/treesitter.lua`
- [Formatting](https://github.com/ivanaguilarjr/nvimconfig/blob/main/lua/ivan/plugins/formatting.lua): `lua/ivan/plugins/formatting.lua`
- [Linting](https://github.com/ivanaguilarjr/nvimconfig/blob/main/lua/ivan/plugins/linting.lua): `lua/ivan/plugins/linting.lua`

### Navigation & UI

- [Telescope](https://github.com/ivanaguilarjr/nvimconfig/blob/main/lua/ivan/plugins/telescope.lua): `lua/ivan/plugins/telescope.lua`
- [File Tree](https://github.com/ivanaguilarjr/nvimconfig/blob/main/lua/ivan/plugins/nvim-tree.lua): `lua/ivan/plugins/nvim-tree.lua`
- [Buffer Line](https://github.com/ivanaguilarjr/nvimconfig/blob/main/lua/ivan/plugins/bufferline.lua): `lua/ivan/plugins/bufferline.lua`
- [Status Line](https://github.com/ivanaguilarjr/nvimconfig/blob/main/lua/ivan/plugins/lualine.lua): `lua/ivan/plugins/lualine.lua`
- [Dashboard](https://github.com/ivanaguilarjr/nvimconfig/blob/main/lua/ivan/plugins/alpha.lua): `lua/ivan/plugins/alpha.lua`
- [Key Discovery](https://github.com/ivanaguilarjr/nvimconfig/blob/main/lua/ivan/plugins/which-key.lua): `lua/ivan/plugins/which-key.lua`
- [UI Prompts](https://github.com/ivanaguilarjr/nvimconfig/blob/main/lua/ivan/plugins/dressing.lua): `lua/ivan/plugins/dressing.lua`
- [Diagnostics View](https://github.com/ivanaguilarjr/nvimconfig/blob/main/lua/ivan/plugins/trouble.lua): `lua/ivan/plugins/trouble.lua`
- [Colorscheme](https://github.com/ivanaguilarjr/nvimconfig/blob/main/lua/ivan/plugins/colorscheme.lua): `lua/ivan/plugins/colorscheme.lua`

### Editing Workflow

- [Git Signs](https://github.com/ivanaguilarjr/nvimconfig/blob/main/lua/ivan/plugins/gitsigns.lua): `lua/ivan/plugins/gitsigns.lua`
- [LazyGit](https://github.com/ivanaguilarjr/nvimconfig/blob/main/lua/ivan/plugins/lazygit.lua): `lua/ivan/plugins/lazygit.lua`
- [Sessions](https://github.com/ivanaguilarjr/nvimconfig/blob/main/lua/ivan/plugins/auto-session.lua): `lua/ivan/plugins/auto-session.lua`
- [Auto Pairs](https://github.com/ivanaguilarjr/nvimconfig/blob/main/lua/ivan/plugins/autopairs.lua): `lua/ivan/plugins/autopairs.lua`
- [Commenting](https://github.com/ivanaguilarjr/nvimconfig/blob/main/lua/ivan/plugins/comment.lua): `lua/ivan/plugins/comment.lua`
- [Indent Guides](https://github.com/ivanaguilarjr/nvimconfig/blob/main/lua/ivan/plugins/indent-blankline.lua): `lua/ivan/plugins/indent-blankline.lua`
- [Rainbow Delimiters](https://github.com/ivanaguilarjr/nvimconfig/blob/main/lua/ivan/plugins/rainbow.lua): `lua/ivan/plugins/rainbow.lua`
- [Substitution](https://github.com/ivanaguilarjr/nvimconfig/blob/main/lua/ivan/plugins/substitute.lua): `lua/ivan/plugins/substitute.lua`
- [Surround Editing](https://github.com/ivanaguilarjr/nvimconfig/blob/main/lua/ivan/plugins/surround.lua): `lua/ivan/plugins/surround.lua`
- [TODO Comments](https://github.com/ivanaguilarjr/nvimconfig/blob/main/lua/ivan/plugins/todo-comments.lua): `lua/ivan/plugins/todo-comments.lua`
- [Window Maximizer](https://github.com/ivanaguilarjr/nvimconfig/blob/main/lua/ivan/plugins/vim-maximizer.lua): `lua/ivan/plugins/vim-maximizer.lua`

### Other components

- **Editor User**
- **Neovim**

## Connections

- Editor User → Neovim: edits with (evidence: `README.md`)
- Config Entry → Neovim: configures
- Lazy Setup → Neovim: managed by (evidence: `README.md`)
