# evanusmodestus/domus-nvim architecture

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

- Interactive diagram: https://gitdiagram.com/evanusmodestus/domus-nvim
- Repository: https://github.com/evanusmodestus/domus-nvim

## Overview

domus-nvim is a layered Neovim configuration for polyglot development and technical writing. The user launches Neovim; its documented entry point loads base configuration before core setup, then the plugin layers provide editor capabilities. Plugin specifications describe what to load, while separate plugin configuration describes how to configure it. The README documents the major capability areas, but no source excerpts were provided, so internal calls beyond the documented load order and layer separation are not asserted.

Main entry points: [`lua/domus/init.lua`](https://github.com/evanusmodestus/domus-nvim/blob/main/lua/domus/init.lua) (Config Entry), [`lua/domus/core`](https://github.com/evanusmodestus/domus-nvim/tree/main/lua/domus/core) (Core Setup), [`lua/domus/plugins/specs`](https://github.com/evanusmodestus/domus-nvim/tree/main/lua/domus/plugins/specs) (Plugin Specifications), [`lua/domus/config`](https://github.com/evanusmodestus/domus-nvim/tree/main/lua/domus/config) (Base Configuration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_startup["Startup and Core"]
  node_entry["Config Entry<br/>[init.lua]"]
  node_base_config["Base Configuration"]
  node_core["Core Setup"]
end

subgraph group_plugin_layers["Plugin Layers"]
  node_plugin_specs["Plugin Specifications"]
  node_plugin_config["Plugin Configuration"]
end

subgraph group_development["Development Tools"]
  node_completion["Completion<br/>[blink.lua]"]
  node_lsp["LSP<br/>[init.lua]"]
  node_format_lint["Format and Lint<br/>[conform.lua]"]
  node_syntax["Syntax Parsing<br/>[treesitter.lua]"]
  node_debug["Debugging<br/>[init.lua]"]
  node_ai["AI Assistance<br/>[coding.lua]"]
end

subgraph group_editor_experience["Editor Experience"]
  node_finder["Finder and Files<br/>[telescope.lua]"]
  node_git["Git Tools<br/>[git.lua]"]
  node_theme["Theme and Highlights<br/>[colorscheme.lua]"]
  node_asciidoc["AsciiDoc Authoring<br/>[asciidoc.lua]"]
end

node_user(("Neovim User"))
node_lazy["lazy.nvim"]

node_user -->|"launches"| node_entry
node_entry -->|"loads first"| node_base_config
node_entry -->|"loads"| node_core
node_core -->|"bootstraps"| node_lazy
node_plugin_specs -->|"separates loading from configuration"| node_plugin_config

click node_entry "https://github.com/evanusmodestus/domus-nvim/blob/main/lua/domus/init.lua"
click node_base_config "https://github.com/evanusmodestus/domus-nvim/tree/main/lua/domus/config"
click node_core "https://github.com/evanusmodestus/domus-nvim/tree/main/lua/domus/core"
click node_plugin_specs "https://github.com/evanusmodestus/domus-nvim/tree/main/lua/domus/plugins/specs"
click node_plugin_config "https://github.com/evanusmodestus/domus-nvim/tree/main/lua/domus/plugins/config"
click node_completion "https://github.com/evanusmodestus/domus-nvim/blob/main/lua/domus/plugins/config/completion/blink.lua"
click node_lsp "https://github.com/evanusmodestus/domus-nvim/blob/main/lua/domus/plugins/config/lsp/init.lua"
click node_format_lint "https://github.com/evanusmodestus/domus-nvim/blob/main/lua/domus/plugins/config/conform.lua"
click node_syntax "https://github.com/evanusmodestus/domus-nvim/blob/main/lua/domus/plugins/config/treesitter.lua"
click node_finder "https://github.com/evanusmodestus/domus-nvim/blob/main/lua/domus/plugins/config/telescope.lua"
click node_git "https://github.com/evanusmodestus/domus-nvim/blob/main/lua/domus/plugins/specs/git.lua"
click node_debug "https://github.com/evanusmodestus/domus-nvim/blob/main/lua/domus/plugins/config/dap/init.lua"
click node_ai "https://github.com/evanusmodestus/domus-nvim/blob/main/lua/domus/plugins/specs/coding.lua"
click node_theme "https://github.com/evanusmodestus/domus-nvim/blob/main/lua/domus/plugins/config/colorscheme.lua"
click node_asciidoc "https://github.com/evanusmodestus/domus-nvim/blob/main/lua/domus/plugins/specs/lang/asciidoc.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_base_config,node_core,node_user toneBlue
class node_plugin_specs,node_plugin_config toneAmber
class node_completion,node_lsp,node_format_lint,node_syntax,node_debug,node_ai toneMint
class node_finder,node_git,node_theme,node_asciidoc toneRose
class node_lazy toneIndigo
```

## Components

### Startup and Core

- [Config Entry](https://github.com/evanusmodestus/domus-nvim/blob/main/lua/domus/init.lua): `lua/domus/init.lua`
- [Base Configuration](https://github.com/evanusmodestus/domus-nvim/tree/main/lua/domus/config): `lua/domus/config`
- [Core Setup](https://github.com/evanusmodestus/domus-nvim/tree/main/lua/domus/core): `lua/domus/core`

### Plugin Layers

- [Plugin Specifications](https://github.com/evanusmodestus/domus-nvim/tree/main/lua/domus/plugins/specs): `lua/domus/plugins/specs`
- [Plugin Configuration](https://github.com/evanusmodestus/domus-nvim/tree/main/lua/domus/plugins/config): `lua/domus/plugins/config`

### Development Tools

- [Completion](https://github.com/evanusmodestus/domus-nvim/blob/main/lua/domus/plugins/config/completion/blink.lua): `lua/domus/plugins/config/completion/blink.lua`
- [LSP](https://github.com/evanusmodestus/domus-nvim/blob/main/lua/domus/plugins/config/lsp/init.lua): `lua/domus/plugins/config/lsp/init.lua`
- [Format and Lint](https://github.com/evanusmodestus/domus-nvim/blob/main/lua/domus/plugins/config/conform.lua): `lua/domus/plugins/config/conform.lua`
- [Syntax Parsing](https://github.com/evanusmodestus/domus-nvim/blob/main/lua/domus/plugins/config/treesitter.lua): `lua/domus/plugins/config/treesitter.lua`
- [Debugging](https://github.com/evanusmodestus/domus-nvim/blob/main/lua/domus/plugins/config/dap/init.lua): `lua/domus/plugins/config/dap/init.lua`
- [AI Assistance](https://github.com/evanusmodestus/domus-nvim/blob/main/lua/domus/plugins/specs/coding.lua): `lua/domus/plugins/specs/coding.lua`

### Editor Experience

- [Finder and Files](https://github.com/evanusmodestus/domus-nvim/blob/main/lua/domus/plugins/config/telescope.lua): `lua/domus/plugins/config/telescope.lua`
- [Git Tools](https://github.com/evanusmodestus/domus-nvim/blob/main/lua/domus/plugins/specs/git.lua): `lua/domus/plugins/specs/git.lua`
- [Theme and Highlights](https://github.com/evanusmodestus/domus-nvim/blob/main/lua/domus/plugins/config/colorscheme.lua): `lua/domus/plugins/config/colorscheme.lua`
- [AsciiDoc Authoring](https://github.com/evanusmodestus/domus-nvim/blob/main/lua/domus/plugins/specs/lang/asciidoc.lua): `lua/domus/plugins/specs/lang/asciidoc.lua`

### Other components

- **Neovim User**
- **lazy.nvim**

## Connections

- Neovim User → Config Entry: launches (evidence: `README.adoc`)
- Config Entry → Base Configuration: loads first (evidence: `README.adoc`)
- Config Entry → Core Setup: loads (evidence: `README.adoc`)
- Core Setup → lazy.nvim: bootstraps (evidence: `README.adoc`)
- Plugin Specifications → Plugin Configuration: separates loading from configuration (evidence: `README.adoc`)
