# sadiksaifi/nvim architecture

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

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

## Overview

##### Main Components

A. Core Components:
- Neovim Core Engine
- Plugin Management System (Lazy.nvim)
- Language Server Protocol (LSP) Infrastructure
- File Management System

B. Plugin Categories:
- Completion Engine (cmp)
- Syntax Highlighting (Treesitter)
- Language Support
- UI Enhancement
- Development Tools

**┌─────────────────────────────────────────────────────────┐**
- User Interface                        │
- (statusline.lua, dressing.lua, colorscheme.lua)        │
- ┤
- Development Tools                       │
- ┌─────────────┐  ┌──────────────┐  ┌───────────────┐  │
- Editor    │  │  Integration │  │  Development   │  │
- Features   │  │   Tools      │  │   Assistance   │  │
- (netrw.lua) │  │ (telescope,  │  │   (copilot,   │  │
- (comment)   │  │  neogit)     │  │   snippets)   │  │
- ┘  └──────────────┘  └───────────────┘  │
- ┤
- Language Support Layer                   │
- ┌─────────────┐  ┌──────────────┐  ┌───────────────┐  │
- LSP      │  │  Treesitter  │  │   Completion  │  │
- Configuration│  │              │  │     (cmp)      │  │
- ┘  └──────────────┘  └───────────────┘  │
- ┤
- Core Configuration                      │
- ┌─────────────┐  ┌──────────────┐  ┌───────────────┐  │
- Options   │  │   Keymaps    │  │   Autocmds    │  │
- ┘  └──────────────┘  └───────────────┘  │
- ┤
- Plugin Management (Lazy.nvim)             │
- ┘

##### Important Relationships to Highlight

- How LSP connects with language servers (typescript.lua, none-ls.lua)
- Connection between completion engine and LSP
- Demonstrate how Treesitter integrates with syntax highlighting
- Plugin dependencies and initialization flow

##### Implementation Details

- Version requirements (Neovim 0.10)

##### Additional Notes

- Keep the focus on web development tooling
- Configuration hierarchy (init.lua → lua/user → lua/plugins)
- External dependencies (node, npm, gcc/clang, ripgrep, fd)
- Initialization flow from init.lua through the configuration chain

## Diagram (Mermaid)

```mermaid
flowchart TB
    subgraph UI["User Interface"]
        direction TB
        StatusLine["Status Line"]:::ui
        Dressing["UI Enhancement"]:::ui
        ColorScheme["Color Scheme"]:::ui
    end

    subgraph DevTools["Development Tools"]
        direction TB
        subgraph Editor["Editor Features"]
            direction TB
            Netrw["File Explorer"]:::editor
            Comment["Code Comments"]:::editor
        end

        subgraph Integration["Integration Tools"]
            direction TB
            Telescope["File Search/Fuzzy Finder"]:::integration
            Neogit["Git Integration"]:::integration
        end

        subgraph Assistance["Development Assistance"]
            direction TB
            Copilot["AI Assistance"]:::assistance
            Snippets["Code Snippets"]:::assistance
        end
    end

    subgraph LangSupport["Language Support Layer"]
        direction TB
        subgraph LSP["LSP System"]
            direction TB
            LSPConfig["LSP Configuration"]:::lsp
            Mason["Language Servers Management"]:::lsp
            TypeScript["TypeScript Support"]:::lsp
            NoneLS["Code Formatting/Linting"]:::lsp
        end

        subgraph Syntax["Syntax System"]
            direction TB
            Treesitter["Treesitter"]:::syntax
        end

        subgraph Completion["Completion System"]
            direction TB
            CMP["Completion Engine"]:::completion
            LuaSnip["Snippets Engine"]:::completion
        end
    end

    subgraph Core["Core Configuration"]
        direction TB
        Options["Options"]:::core
        Keymaps["Keymaps"]:::core
        Autocmds["Autocmds"]:::core
    end

    subgraph PluginMgmt["Plugin Management"]
        direction TB
        Lazy["Lazy.nvim"]:::plugin
    end

    subgraph LangConfig["Language-Specific Configurations"]
        direction TB
        JSON["JSON Config"]:::langconfig
        TSSnippets["TypeScript Snippets"]:::langconfig
        ReactSnippets["React TypeScript Snippets"]:::langconfig
        FileDetect["File Type Detection"]:::langconfig
    end

    %% Relationships
    Lazy --> Core
    Lazy --> DevTools
    Lazy --> LangSupport
    Lazy --> UI
    
    Core --> DevTools
    Core --> LangSupport
    
    LSP --> Completion
    Treesitter --> Completion
    
    LangSupport --> UI
    DevTools --> UI

    %% Click Events
    click Options "https://github.com/sadiksaifi/nvim/blob/main/lua/user/options.lua"
    click Keymaps "https://github.com/sadiksaifi/nvim/blob/main/lua/user/keymaps.lua"
    click Autocmds "https://github.com/sadiksaifi/nvim/blob/main/lua/user/autocmds.lua"
    click Lazy "https://github.com/sadiksaifi/nvim/blob/main/lua/user/lazy-setup.lua"
    click LSPConfig "https://github.com/sadiksaifi/nvim/blob/main/lua/plugins/lspconfig.lua"
    click Mason "https://github.com/sadiksaifi/nvim/blob/main/lua/plugins/mason.lua"
    click Treesitter "https://github.com/sadiksaifi/nvim/blob/main/lua/plugins/treesitter.lua"
    click CMP "https://github.com/sadiksaifi/nvim/blob/main/lua/plugins/cmp.lua"
    click TypeScript "https://github.com/sadiksaifi/nvim/blob/main/lua/plugins/typescript.lua"
    click NoneLS "https://github.com/sadiksaifi/nvim/blob/main/lua/plugins/none-ls.lua"
    click LuaSnip "https://github.com/sadiksaifi/nvim/blob/main/lua/plugins/luasnip.lua"
    click Netrw "https://github.com/sadiksaifi/nvim/blob/main/plugin/netrw.lua"
    click Neogit "https://github.com/sadiksaifi/nvim/blob/main/lua/plugins/neogit.lua"
    click Telescope "https://github.com/sadiksaifi/nvim/blob/main/lua/plugins/telescope.lua"
    click Comment "https://github.com/sadiksaifi/nvim/blob/main/lua/plugins/comment.lua"
    click Copilot "https://github.com/sadiksaifi/nvim/blob/main/lua/plugins/copilot.lua"
    click StatusLine "https://github.com/sadiksaifi/nvim/blob/main/plugin/statusline.lua"
    click Dressing "https://github.com/sadiksaifi/nvim/blob/main/lua/plugins/dressing.lua"
    click ColorScheme "https://github.com/sadiksaifi/nvim/blob/main/lua/plugins/colorscheme.lua"
    click JSON "https://github.com/sadiksaifi/nvim/blob/main/after/ftplugin/json.lua"
    click TSSnippets "https://github.com/sadiksaifi/nvim/blob/main/snippets/typescript.json"
    click ReactSnippets "https://github.com/sadiksaifi/nvim/blob/main/snippets/typescriptreact.json"
    click FileDetect "https://github.com/sadiksaifi/nvim/tree/main/ftdetect"

    %% Styles
    classDef core fill:#90EE90,stroke:#333,stroke-width:2px
    classDef plugin fill:#FFB6C1,stroke:#333,stroke-width:2px
    classDef lsp fill:#87CEEB,stroke:#333,stroke-width:2px
    classDef syntax fill:#87CEEB,stroke:#333,stroke-width:2px
    classDef completion fill:#87CEEB,stroke:#333,stroke-width:2px
    classDef editor fill:#FFA500,stroke:#333,stroke-width:2px
    classDef integration fill:#FFA500,stroke:#333,stroke-width:2px
    classDef assistance fill:#FFA500,stroke:#333,stroke-width:2px
    classDef ui fill:#DDA0DD,stroke:#333,stroke-width:2px
    classDef langconfig fill:#98FB98,stroke:#333,stroke-width:2px
```
