💫 Neovim

January 28, 2026 · View on GitHub

A fast and highly customisable Neovim IDE with lazy loading, and modular configurations.

Heavy and bloated

📑 ToC

📸 Showcase

DashboardEditor
DashboardEditor
DebuggingAI
DebuggingAI

🔥 Supports

Plugins

  • Highly customisable plugin manager with lazy.nvim
  • Package manager with mason.nvim

    optional, you can disable this, and install package yourself

  • NvChad UI
  • Task runner, builtin file runner
  • Formatting, linting, debugging, testing
  • Querying database, rest api, json, yaml
  • AI integration with tab completion, MCP, VectorCode
  • Fast find files, image viewer with snacks.nvim
  • Others: translate, session, chezmoi, wakatime

Note

And much more...! You will get lost in this config.

Languages

Note

The higher the order, the better configured the language is

  • Author using:
    • javascript, typescript (nodejs, deno)

      deno: Install from mason or external yourself

    • go
    • python
    • sql (postgresql)
    • github (github_action)
    • gitlab
    • shell
    • docker
  • Others:
    • java
    • c, cpp
    • html
    • css
    • react
    • tailwind
    • c#/cs
    • flutter (dart)
    • vim
    • rust
    • kotlin
    • powershell
    • sql

      mssql: Haven't test

    • lua

      Just for configuring neovim :((

  • Ops:
    • groovy + jenkinsfile
    • hcl+ terraform
    • kubernetes
    • helm
    • nginx
    • ansible
  • Configuring languages:
    • toml
    • yaml
    • xml
    • config (sshconfig, tmux)
    • kmonad
    • grafana (alloy)
  • Writing:
    • markdown
    • latex
    • d2
    • plantuml

Note

See lua/plugins/extras/languages/ for more detail

🥴 Usage

Prerequisites

  • neovim:

    version >= 0.11

  • make: Some plugins require this
  • curl
  • delta
  • ripgrep: telescope, vimgrep replacement
  • fd: telescope
  • npm, npx: for some plugins and stuff installed via Mason, treesitter generate
  • go: Some stuff installed via Mason
  • treesitter cli: to use treesitter

Note

If you don't use mason, never mind those requirements from Mason

Install

# echo 'please star this repo!'
# sudo rm -rf /

Note

I suggest forking this repo in order to up to date with the upstream (this repo)

Warning

We all know how to do that

You shouldn't enter nvim for now. Use nvim --clean ./lua/plugins/languages/init.lua or another editor to edit the lua/plugins/languages/init.lua!!! Otherwise you will install tons of plugins and requirements from what I'm using.

Structure

lua
├── configs                 Extendable settings for builtin, plugins options
│   ├── dap                 nvim-dap config
│   │   └── ...
│   ├── diagnostic          (Neo)vim diagnostic setup
│   ├── lazy                lazy.nvim config
│   ├── mason               Mason's config (custom registries)
│   ├── lsp                 Neovim's lsp setting
│   ├── runner              Builtin file runner
│   └── ui                  UI (mostly for nvchad)
│       └── ...
├── core                    (Neo)vim native settings
├── overseer                overseer.nvim templates
│   └── template
│       └── default
├── plugins                 lazy.nvim plugins specs
│   ├── extras              Plugins can be toggle
│   │   ├── ai              AI integration
│   │   ├── blink           blink.cmp extensions
│   │   ├── chezmoi         Chezmoi stuff
│   │   ├── coding          Package manager, lint, format
│   │   ├── dap             Debug
│   │   ├── database        Database
│   │   ├── git             Easier to interact with git
│   │   ├── languages       User's preference to enable
│   │   │   └── ...
│   │   ├── lsp             Enhance LSP usage
│   │   ├── mason           Mason package manager
│   │   ├── motion          Extend neovim motions
│   │   ├── others          Others
│   │   ├── silly           When you are stress
│   │   ├── telescope       Telescope extensions
│   │   ├── test            Testing
│   │   ├── ui              Extend UI things
│   └── main                Shouldn't disable, you don't want to break the config
├── types                   Custom types, overriding types for lua annotating
└── utils                   Utilities

Note

Extra plugins in lua/plugins/extras are (may) safely disabled. You should disable by group in lua/plugins/extras/init.lua, lua/plugins/extras/languages/init.lua, and individually in lua/plugins/extras/others.

📒 Notes

Keymaps

There are some keymaps you should know in this config (and native neovim keymaps)

Note

ModeKeymapDescriptions
n<leader><leader>Find Files
n<leader>eToggle File Tree
n<leader>TabOpen File Tree and Focus Current File
n<leader>yYank all into System Clipboard
nHNavigate Left Buffer in NvChad Tabufline
nLNavigate Right Buffer in NvChad Tabufline
n<leader>cClose Buffer
n<leader><Esc>No Highlight Search Matches
n<C-s>Save Buffer
nZZWrite Quit
nZQQuit
i<C-s>LSP Show Signature
n<C-w><C-d>LSP Float Diagnostic
nKLSP Hover Documentation
n<leader>atToggle AI Completion Suggestion
n<leader>oHUncloak The File laytan/cloak.nvim

Warning

With completion behavior, see questions below

Should read

  • Setting up new LSP in after/lsp/

    For better overriding

  • Use mason tools to install all packages (Language servers, linters, formatters, runtime) 
    :MasonToolsInstall
  • Plugins are updated every week (set in lazy config)
  • Some languages pack require others, you should (or must?) enable yourself:
    • rest: http
    • jenkins: groovy
    • react: typescript
    • ansible: yaml (for yaml syntax highlighting)
  • Set $NVIM_NO_IDE to any value to disable lsp, format, lint (quick editing)

    Ex:

     NVIM_NO_IDE=1 lazygit # commit, quick edit
  • Working with sql:
    • With PostgreSQL or PLpgSQL,..., set ft to pgsql and not using treesitter, but lifepillar/pgsql.vim

      Ex:

      • # vim: set ft=pgsql:
  • Working with latex:
    • on Arch: 
      pacman -Sy texlive-latex texlive-latexextra texlive-binextra texlive-langother libxcrypt-compat
pacman -S texlive-fontextra # For fonts...
    • other: idk
  • helm_ls includes yaml_ls already, no need to run yaml_ls
  • With groovy-language-server, ensure you are using java@18 or so...

For configuring

  • lazy.nvim only run config and init once. Not like opts
  • If NvChad UI's color is broken, use <leader>ur
  • Don't use NvChad's auto command
  • lsp currently not enabled by compound filetype
  • nvim-lint can lint the compound filetype
  • conform format the last filetype in the compound file, one by one
  • PlantUML tree-sitter queries from here

✏️ Others

Questions

Control space in Windows Terminal doesn't work

On windows terminal which cannot send Ctrl + Space into shell, you can send Ctrl + Space as Alt + ; by editing windows terminal config json (LocalState/settings.json):

{
  "actions": [
    {
      "command": {
        "action": "sendInput",
        "input": "\u001b;"
      },
      "id": "User.sendInput.63E68121",
      "keys": "ctrl+space"
    }
  ]
}

Change the behavior of completion

See https://cmp.saghen.dev/configuration/keymap.html and change lua/plugins/main/blink-cmp.lua. You should read all the docs.

Change the NvChad UI

It may be possible. But it may require times to config.

Tips & Tricks

References