# victorfernandesraton/nvim architecture

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

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

## Overview

##### Project type and purpose
- This is an open-source, Lua-based Neovim configuration (“raton.dev nvim config”) designed to bootstrap and customize Neovim for Python development (and general editing) using a modular, lazy-loaded plugin approach.

##### File structure
- Top-level files:
- init.lua – the entry point that tells Neovim how to load your Lua config
- README.md – usage instructions and prerequisites
- lua/vraton/core – core settings (key remaps, options)
- init.lua – core loader
- remap.lua, set.lua – basic editor configuration
- lua/vraton/lazy.lua – plugin manager setup (bootstrap of Lazy.nvim)
- lua/vraton/plugins – individual plugin specs and configurations, grouped by feature (alpha, autopairs, lsp, dap, git, etc.)
- plugin subdirectories (lsp, dap, environment) represent logical extensions and lazy-load conditions.

##### README for additional insights
- Lists prerequisites (Neovim ≥0.10, fonts, external tools)
- Instructs on symlinking to ~/.config/nvim and running Lazy.nvim/Mason™ on first launch

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Entry Point
    Neovim["Neovim Runtime"]:::entry
    Init["init.lua"]:::entry
    Neovim -->|"loads"| Init

    %% Core Modules
    subgraph "Core Modules"
        direction TB
        CoreLoader["core/init.lua"]:::core
        Remap["core/remap.lua"]:::core
        Set["core/set.lua"]:::core
    end
    Init -->|"requires"| CoreLoader
    CoreLoader --> Remap
    CoreLoader --> Set

    %% Plugin Manager
    Lazy["lazy.lua"]:::core
    Init -->|"requires"| Lazy

    %% Plugins
    subgraph "Plugin Configurations"
        direction TB
        PluginsIndex["plugins/init.lua"]:::plugin

        Alpha["alpha.lua"]:::plugin
        AutoPairs["autopairs.lua"]:::plugin
        Autosession["autosession.lua"]:::plugin

        subgraph "DAP Plugins"
            direction TB
            DapCore["dap/nvim-dap.lua"]:::plugin
            DapVirtual["dap/nvim-dap-virtual-test.lua"]:::plugin
            DapNeotest["dap/nvim-neotest.lua"]:::plugin
        end

        subgraph "Environment Plugins"
            direction TB
            PythonVenv["enviroment/python-venv.lua"]:::plugin
        end

        subgraph "LSP Plugins"
            direction TB
            Mason["lsp/mason.lua"]:::plugin
            LspConfig["lsp/nvim-lspconfig.lua"]:::plugin
            Completion["lsp/nvim-cmp.lua"]:::plugin
            Lint["lsp/lint.lua"]:::plugin
        end

        Telescope["telescope.lua"]:::plugin
        Git["git.lua"]:::plugin
        Treesitter["tresitter.lua"]:::plugin
        Lualine["lualine.lua"]:::plugin
        NvimTree["nvim-tree.lua"]:::plugin
        Comment["nvim-comment.lua"]:::plugin
        Surround["sorround.lua"]:::plugin
        ToggleTerm["toggleterm-nvim.lua"]:::plugin

        subgraph "Utilities"
            direction TB
            Harpoon["harpoon2.lua"]:::plugin
            Blankline["ident-blankline.lua"]:::plugin
            CodeSnap["codesnap-nvim.lua"]:::plugin
            TodoComments["todo-comments.lua"]:::plugin
            UndoTree["undotree.lua"]:::plugin
            WhichKey["whitch-key.lua"]:::plugin
            Gopher["gopher-nvim.lua"]:::plugin
            Colorscheme["colorscheme.lua"]:::plugin
            Aider["aider-nvim.lua"]:::plugin
            Swenv["swenv.lua"]:::plugin
        end
    end

    Lazy -->|"reads specs"| PluginsIndex
    PluginsIndex --> Alpha
    PluginsIndex --> AutoPairs
    PluginsIndex --> Autosession
    PluginsIndex --> DapCore
    PluginsIndex --> DapVirtual
    PluginsIndex --> DapNeotest
    PluginsIndex --> PythonVenv
    PluginsIndex --> Mason
    PluginsIndex --> LspConfig
    PluginsIndex --> Completion
    PluginsIndex --> Lint
    PluginsIndex --> Telescope
    PluginsIndex --> Git
    PluginsIndex --> Treesitter
    PluginsIndex --> Lualine
    PluginsIndex --> NvimTree
    PluginsIndex --> Comment
    PluginsIndex --> Surround
    PluginsIndex --> ToggleTerm
    PluginsIndex --> Harpoon
    PluginsIndex --> Blankline
    PluginsIndex --> CodeSnap
    PluginsIndex --> TodoComments
    PluginsIndex --> UndoTree
    PluginsIndex --> WhichKey
    PluginsIndex --> Gopher
    PluginsIndex --> Colorscheme
    PluginsIndex --> Aider
    PluginsIndex --> Swenv

    %% External Services
    subgraph "External Tools & Services"
        direction TB
        MasonSvc["Mason.nvim"]:::external
        LSPServers["LSP Servers"]:::external
        DAPServers["DAP Servers"]:::external
        Ripgrep["ripgrep / FZF"]:::external
        Python["Python Interpreter"]:::external
        GitSvc["Git CLI"]:::external
        Clipboard["System Clipboard"]:::external
    end

    Mason -->|"installs"| LSPServers
    LSPConfig -->|"configures"| LSPServers
    DapCore -->|"connects to"| DAPServers
    Telescope -->|"uses"| Ripgrep
    Alpha -->|"displays"| Python
    Git -->|"uses"| GitSvc
    AnyPlugin["Any plugin"] -->|"uses"| Clipboard
    class AnyPlugin plugin

    %% Click Events
    click Init "https://github.com/victorfernandesraton/nvim/blob/main/init.lua"
    click CoreLoader "https://github.com/victorfernandesraton/nvim/blob/main/lua/vraton/core/init.lua"
    click Remap "https://github.com/victorfernandesraton/nvim/blob/main/lua/vraton/core/remap.lua"
    click Set "https://github.com/victorfernandesraton/nvim/blob/main/lua/vraton/core/set.lua"
    click Lazy "https://github.com/victorfernandesraton/nvim/blob/main/lua/vraton/lazy.lua"
    click PluginsIndex "https://github.com/victorfernandesraton/nvim/blob/main/lua/vraton/plugins/init.lua"
    click Alpha "https://github.com/victorfernandesraton/nvim/blob/main/lua/vraton/plugins/alpha.lua"
    click AutoPairs "https://github.com/victorfernandesraton/nvim/blob/main/lua/vraton/plugins/autopairs.lua"
    click Autosession "https://github.com/victorfernandesraton/nvim/blob/main/lua/vraton/plugins/autosession.lua"
    click DapVirtual "https://github.com/victorfernandesraton/nvim/blob/main/lua/vraton/plugins/dap/nvim-dap-virtual-test.lua"
    click DapCore "https://github.com/victorfernandesraton/nvim/blob/main/lua/vraton/plugins/dap/nvim-dap.lua"
    click DapNeotest "https://github.com/victorfernandesraton/nvim/blob/main/lua/vraton/plugins/dap/nvim-neotest.lua"
    click PythonVenv "https://github.com/victorfernandesraton/nvim/blob/main/lua/vraton/plugins/enviroment/python-venv.lua"
    click Mason "https://github.com/victorfernandesraton/nvim/blob/main/lua/vraton/plugins/lsp/mason.lua"
    click LspConfig "https://github.com/victorfernandesraton/nvim/blob/main/lua/vraton/plugins/lsp/nvim-lspconfig.lua"
    click Completion "https://github.com/victorfernandesraton/nvim/blob/main/lua/vraton/plugins/lsp/nvim-cmp.lua"
    click Lint "https://github.com/victorfernandesraton/nvim/blob/main/lua/vraton/plugins/lsp/lint.lua"
    click Telescope "https://github.com/victorfernandesraton/nvim/blob/main/lua/vraton/plugins/telescope.lua"
    click Git "https://github.com/victorfernandesraton/nvim/blob/main/lua/vraton/plugins/git.lua"
    click Treesitter "https://github.com/victorfernandesraton/nvim/blob/main/lua/vraton/plugins/tresitter.lua"
    click Lualine "https://github.com/victorfernandesraton/nvim/blob/main/lua/vraton/plugins/lualine.lua"
    click NvimTree "https://github.com/victorfernandesraton/nvim/blob/main/lua/vraton/plugins/nvim-tree.lua"
    click Comment "https://github.com/victorfernandesraton/nvim/blob/main/lua/vraton/plugins/nvim-comment.lua"
    click Surround "https://github.com/victorfernandesraton/nvim/blob/main/lua/vraton/plugins/sorround.lua"
    click ToggleTerm "https://github.com/victorfernandesraton/nvim/blob/main/lua/vraton/plugins/toggleterm-nvim.lua"
    click Harpoon "https://github.com/victorfernandesraton/nvim/blob/main/lua/vraton/plugins/harpoon2.lua"
    click Blankline "https://github.com/victorfernandesraton/nvim/blob/main/lua/vraton/plugins/ident-blankline.lua"
    click CodeSnap "https://github.com/victorfernandesraton/nvim/blob/main/lua/vraton/plugins/codesnap-nvim.lua"
    click TodoComments "https://github.com/victorfernandesraton/nvim/blob/main/lua/vraton/plugins/todo-comments.lua"
    click UndoTree "https://github.com/victorfernandesraton/nvim/blob/main/lua/vraton/plugins/undotree.lua"
    click WhichKey "https://github.com/victorfernandesraton/nvim/blob/main/lua/vraton/plugins/whitch-key.lua"
    click Gopher "https://github.com/victorfernandesraton/nvim/blob/main/lua/vraton/plugins/gopher-nvim.lua"
    click Colorscheme "https://github.com/victorfernandesraton/nvim/blob/main/lua/vraton/plugins/colorscheme.lua"
    click Aider "https://github.com/victorfernandesraton/nvim/blob/main/lua/vraton/plugins/aider-nvim.lua"
    click Swenv "https://github.com/victorfernandesraton/nvim/blob/main/lua/vraton/plugins/swenv.lua"

    %% Styles
    classDef entry fill:#DDEEFF,stroke:#333,stroke-width:1px
    classDef core fill:#EEFFFF,stroke:#333,stroke-width:1px
    classDef plugin fill:#E0FFE0,stroke:#333,stroke-width:1px
    classDef external fill:#FFE0B2,stroke:#333,stroke-width:1px
```
