# smrenato/nvim architecture

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

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

## Overview

##### Project type and purpose
- This is not a traditional “app” but a customized Neovim configuration repository (“dotfiles”) written in Lua.
- Its core purpose is to configure and extend Neovim with fast startup, LSP support, fuzzy‐finding, syntax trees, theming, and formatting primarily for Rust and Python.

##### File structure
- Top level:
– init.lua: Neovim’s entry point that bootstrap-loads the Lua config.
– lazy-lock.json & stylua.toml: lockfile & formatter config.
– README.md/.gitignore.
– lsp/: per-server LSP settings (rust_analyzer, pyright, etc.).
– lua/: contains three main subtrees:
· config/: user custom autocmds, keymaps, options
· core/: bootstrapping logic (lazy plugin manager, core settings, LSP wiring, extras)
· plugins/: per-plugin configuration (colorschemes, cmp, fzf, treesitter, mini‐plugins, etc.)

##### README for additional insights
- Confirms technical stack: Neovim 0.11+, Lua, LSP servers (Rust, Python), external tools (ripgrep, fzf, tree-sitter).
- Lists installed plugins and features: lazy.vim, blink.cmp, conform.nvim, fzf-lua, tree-sitter, mini.nvim, mason, etc.

a. Main components
- User (you typing in Neovim)
- Neovim core runtime (C code + embedded Lua VM)
- init.lua bootstrap
- Core modules (lua/core)
- Plugin manager (lazy.nvim)
- Plugin configurations (lua/plugins & lua/config)
- LSP integration layer (lua/core/lsp + lsp/* files + external LSP servers)
- External utilities (ripgrep, fzf, tree-sitter-cli, nerd font)

b. Relationships & interactions
- User keystroke → Neovim core → init.lua
- init.lua → loads lua/core (sets up lazy manager & global options)
- lazy.nvim → reads plugin specs (lua/plugins) → installs & initializes each plugin
- Plugins → hook into Neovim API (e.g., blink.cmp registers completion providers)
- LSP integration: lua/core/lsp wires lsp/* settings → external language-server processes
- Formatter (conform.nvim) invoked via autocmds (lua/config/autocmds.lua)
- Fuzzy finder (fzf-lua) spawns ripgrep subprocess
- Treesitter CLI used at install time, but runtime uses Neovim’s treesitter plugin

c. Architectural patterns & design principles
- Modular layering:
– Bootstrap layer (init.lua)
– Core configuration layer (lua/core)
– Plugin specification layer (lua/plugins)
– Plugin-specific config layer (lua/config)
- Dependency injection via lazy.nvim: plugins aren’t loaded until needed
- Separation of concerns: LSP config isolated under lsp/; UI tweaks under plugins/colorschemes, diagnostic, etc.

d. Key technologies & frameworks
- Lua (Neovim’s config language)
- lazy.nvim (plugin manager)
- Mason (installing LSP, linters, DAP)
- blink.cmp (completion)
- fzf-lua & ripgrep (fuzzy search)
- tree-sitter & tree-sitter-cli (syntax parsing)
- conform.nvim (formatting)

##### Detail over minimalism
- Every distinct plugin group so no hidden dependencies.
- Build/install-time steps (e.g., tree-sitter-cli invocation by plugin) vs. runtime flows.

## Diagram (Mermaid)

```mermaid
graph TB
    %% Top Level
    User["User (keystrokes)"]:::external
    NeovimCore["Neovim Core Runtime"]:::external
    Init["init.lua"]:::internal
    Lockfile["lazy-lock.json & stylua.toml"]:::internal

    %% Bootstrap Layer
    subgraph "Bootstrap Layer"
        Init
        Lockfile
    end

    %% Core Layer
    subgraph "Core Configuration Layer"
        Cfg["lua/core/cfg.lua\n(Core Settings)"]:::internal
        LazySetup["lua/core/lazy.lua\n(Plugin Manager Setup)"]:::internal
        LspWire["lua/core/lsp.lua\n(LSP Wiring)"]:::internal
        LspExtras["lua/core/lsp_extras.lua\n(LSP Helpers)"]:::internal
    end

    %% Plugin Manager
    subgraph "Plugin Manager"
        LazyManager["lazy.nvim"]:::plugin
    end

    %% Plugin Specifications
    subgraph "Plugin Specifications"
        Blink["lua/plugins/blink_cmp.lua\n(Completion)"]:::plugin
        Colors["lua/plugins/colorschemes.lua\n(Theming)"]:::plugin
        Conform["lua/plugins/conform.lua\n(Formatting)"]:::plugin
        Diagnostic["lua/plugins/diagnostic.lua\n(Diagnostics UI)"]:::plugin
        Fidget["lua/plugins/fidget.lua\n(LSP Progress)"]:::plugin
        Fzf["lua/plugins/fzf_lua.lua\n(Fuzzy Finder)"]:::plugin
        GitSigns["lua/plugins/gitsigns.lua\n(Git Signs)"]:::plugin
        GuessIndent["lua/plugins/guess_indent.lua\n(Indentation)"]:::plugin
        Mason["lua/plugins/mason.lua\n(LSP Installer)"]:::plugin
        Mini["lua/plugins/mini_nvim.lua\n(Utilities)"]:::plugin
        Treesitter["lua/plugins/treesitter.lua\n(Treesitter)"]:::plugin
        WhichKey["lua/plugins/which_key.lua\n(Keybinding Helper)"]:::plugin
    end

    %% User Config Layer
    subgraph "User Configuration Layer"
        Autocmds["lua/config/autocmds.lua\n(Autocommands)"]:::internal
        Keymaps["lua/config/keymaps.lua\n(Keymaps)"]:::internal
        Options["lua/config/options.lua\n(Global Options)"]:::internal
    end

    %% LSP Settings
    subgraph "Per-Server LSP Settings"
        RustAnalyzer["lsp/rust_analyzer.lua"]:::internal
        Ruff["lsp/ruff.lua"]:::internal
        BasePyright["lsp/basedpyright.lua"]:::internal
        LuaLS["lsp/lua_ls.lua"]:::internal
    end

    %% External Tools & Servers
    subgraph "External Binaries & Servers"
        RustSrv["rust-analyzer"]:::external
        PyrightSrv["pyright"]:::external
        RuffSrv["ruff"]:::external
        LuaSrv["lua-language-server"]:::external
        Ripgrep["ripgrep"]:::external
        FzfCli["fzf subprocess"]:::external
        TreesitterCLI["tree-sitter-cli"]:::external
        NerdFont["Nerd Font"]:::external
    end

    %% Relationships
    User --> NeovimCore
    NeovimCore --> Init
    Init --> Cfg
    Init --> LazySetup
    Init --> LspWire
    Init --> LspExtras
    Init --> Autocmds
    Init --> Keymaps
    Init --> Options

    LazySetup --> LazyManager

    LazyManager --> Blink
    LazyManager --> Colors
    LazyManager --> Conform
    LazyManager --> Diagnostic
    LazyManager --> Fidget
    LazyManager --> Fzf
    LazyManager --> GitSigns
    LazyManager --> GuessIndent
    LazyManager --> Mason
    LazyManager --> Mini
    LazyManager --> Treesitter
    LazyManager --> WhichKey

    Blink --> NeovimCore
    Colors --> NeovimCore
    Conform --> Autocmds
    Diagnostic --> NeovimCore
    Fidget --> NeovimCore
    Fzf --> FzfCli
    FzfCli --> Ripgrep
    GitSigns --> NeovimCore
    GuessIndent --> NeovimCore
    Mason --> RustSrv
    Mason --> PyrightSrv
    Mason --> RuffSrv
    Mason --> LuaSrv
    Mini --> NeovimCore
    Treesitter --> TreesitterCLI
    TreesitterCLI --> NeovimCore
    WhichKey --> NeovimCore

    LspWire --> RustAnalyzer
    LspWire --> Ruff
    LspWire --> BasePyright
    LspWire --> LuaLS
    RustAnalyzer --> RustSrv
    BasePyright --> PyrightSrv
    Ruff --> RuffSrv
    LuaLS --> LuaSrv

    %% Click Events
    click Init "https://github.com/smrenato/nvim/blob/master/init.lua"
    click Lockfile "https://github.com/smrenato/nvim/blob/master/lazy-lock.json"
    click Lockfile "https://github.com/smrenato/nvim/blob/master/stylua.toml"
    click Cfg "https://github.com/smrenato/nvim/blob/master/lua/core/cfg.lua"
    click LazySetup "https://github.com/smrenato/nvim/blob/master/lua/core/lazy.lua"
    click LspWire "https://github.com/smrenato/nvim/blob/master/lua/core/lsp.lua"
    click LspExtras "https://github.com/smrenato/nvim/blob/master/lua/core/lsp_extras.lua"
    click Blink "https://github.com/smrenato/nvim/blob/master/lua/plugins/blink_cmp.lua"
    click Colors "https://github.com/smrenato/nvim/blob/master/lua/plugins/colorschemes.lua"
    click Conform "https://github.com/smrenato/nvim/blob/master/lua/plugins/conform.lua"
    click Diagnostic "https://github.com/smrenato/nvim/blob/master/lua/plugins/diagnostic.lua"
    click Fidget "https://github.com/smrenato/nvim/blob/master/lua/plugins/fidget.lua"
    click Fzf "https://github.com/smrenato/nvim/blob/master/lua/plugins/fzf_lua.lua"
    click GitSigns "https://github.com/smrenato/nvim/blob/master/lua/plugins/gitsigns.lua"
    click GuessIndent "https://github.com/smrenato/nvim/blob/master/lua/plugins/guess_indent.lua"
    click Mason "https://github.com/smrenato/nvim/blob/master/lua/plugins/mason.lua"
    click Mini "https://github.com/smrenato/nvim/blob/master/lua/plugins/mini_nvim.lua"
    click Treesitter "https://github.com/smrenato/nvim/blob/master/lua/plugins/treesitter.lua"
    click WhichKey "https://github.com/smrenato/nvim/blob/master/lua/plugins/which_key.lua"
    click Autocmds "https://github.com/smrenato/nvim/blob/master/lua/config/autocmds.lua"
    click Keymaps "https://github.com/smrenato/nvim/blob/master/lua/config/keymaps.lua"
    click Options "https://github.com/smrenato/nvim/blob/master/lua/config/options.lua"
    click RustAnalyzer "https://github.com/smrenato/nvim/blob/master/lsp/rust_analyzer.lua"
    click Ruff "https://github.com/smrenato/nvim/blob/master/lsp/ruff.lua"
    click BasePyright "https://github.com/smrenato/nvim/blob/master/lsp/basedpyright.lua"
    click LuaLS "https://github.com/smrenato/nvim/blob/master/lsp/lua_ls.lua"

    %% Styles
    classDef internal fill:#AED6F1,stroke:#1B4F72,color:#0B2343
    classDef plugin fill:#ABEBC6,stroke:#186A3B,color:#145A32
    classDef external fill:#F9E79F,stroke:#B9770E,color:#7E5109

    %% Legend
    subgraph Legend
        A["Internal Config"]:::internal
        B["Plugin Subsystem"]:::plugin
        C["External Tools"]:::external
    end
```
