Step into the realm of excellence with my world-class Neovim (nvim) configuration! This comprehensive guide unveils a meticulously crafted zenful setup, meticulously designed for unparalleled efficiency, productivity, and visual splendor within Neovim.
Embark on a journey through a domain enriched with powerful features, plugins, and finely tuned key bindings, addressing a diverse range of coding/text-editing requirements. Welcome to a sublime Neovim experience tailored to elevate your coding endeavors to new heights! π₯
## July, 2026 Preview π
## 2025 Preview
## β‘ TL;DR β One Command
```shell
npx colson-nvim@latest
```
Then launch `nvim`. That's it. π
lazy.nvim bootstraps itself, and every plugin restores to an **exact, tested
commit** from the committed `lazy-lock.json` β the same known-good setup on
every machine, every time. Your previous config (if any) is automatically
backed up to `~/.config/nvim.backup-` first.
## π What's New (July 2026) β The Future-Proof Release
This release is a ground-up modernization of the plugin infrastructure while
keeping every keybinding and workflow you know exactly the same:
- 𧩠**lazy.nvim plugin manager** β packer.nvim was archived upstream in 2023;
the config now runs on the actively maintained industry standard. Your
muscle memory survives: `:PackerSync`, `:PackerInstall`, `po`, and
`pac` all still work as compatibility shims that delegate to lazy.
- π **Reproducible installs** β `lazy-lock.json` pins all ~64 plugins to
exact commits. Fresh machine = identical editor. `:Lazy restore` puts
everything back to the tested state at any time.
- π₯οΈ **Dashboard start screen** ([dashboard-nvim](https://github.com/nvimdev/dashboard-nvim))
with **BOTH layouts configured**: **DOOM** (default) and **HYPER** β
switchable at runtime. See [Dashboard](#%EF%B8%8F-dashboard--start-screen).
- π² **Treesitter `main` branch** β the only branch that supports Neovim 0.12+.
Highlighting and indentation now use Neovim's native `vim.treesitter` APIs.
- π **telescope-fzf-native** β compiled C fuzzy matcher; instant fuzzy
finding even on giant monorepos.
- π©Ί **fidget.nvim** β live LSP indexing progress (see tsserver/jdtls/gopls
warm up on large codebases instead of guessing).
- 𧬠**gitsigns.nvim** β hunk-level change indicators in the gutter, tuned
with large-repo safety limits.
- β **Java stack repaired & modernized** β nvim-java 4.x with bundled
components, mason-curated jdtls versions (no more dead download URLs), and
the modern `vim.lsp.config()` API (no deprecated lspconfig framework calls).
- π§― **Startup hardening** β zero blocking errors on boot, stale server names
fixed (`tsserver` β `ts_ls`), version-pin rot eliminated, undo directory
auto-created on fresh machines.
## π₯οΈ Dashboard β Start Screen
Launching `nvim` with no arguments now opens a beautiful start screen with the
COLSON banner, quick actions, and startup stats. Both official layouts ship
pre-configured:
| Command | What it does |
| ----------------------- | ------------------------------------------ |
| `:Dashboard` | Open the dashboard (current theme) |
| `:DashboardDoom` | Switch to the **DOOM** layout (default) π |
| `:DashboardHyper` | Switch to the **HYPER** layout β‘ |
| `:DashboardToggleTheme` | Toggle DOOM β HYPER |
**DOOM layout (default)** β a focused vertical menu:
| Key | Action |
| --- | --------------------------- |
| `f` | Find File (Telescope) |
| `r` | Recent Files |
| `g` | Live Grep |
| `e` | File Explorer (NvimTree) |
| `n` | New File |
| `c` | Browse this Neovim config |
| `u` | Sync Plugins (`:Lazy sync`) |
| `q` | Quit |
**HYPER layout** β shortcut pills + recent projects + MRU files with hotkeys,
plus live startup time and plugin stats.
Every launch path does the right thing:
| You type | You get |
| --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `nvim` | The DOOM dashboard |
| `nvim .` / `nvim ~/project` | Straight into the project: session rooted there (`:cd`), netrw listing in the background, Telescope Find Files floating on top β zero keystrokes to your code, dismiss the picker and you're browsing |
| `nvim file.ts` | The file, instantly β nothing in between |
The palette is a neon hacker set on true black: matrix-green banner
(`#00ff9f`), cyan icons, magenta hotkeys β reapplied automatically on every
`:colorscheme` change so it never washes out.
> π‘ Prefer the classic auto-Telescope-on-startup behavior? It's preserved
> behind a flag: set `vim.g.colson_startup_telescope = true` in
> `lua/colson/set.lua`.
## Installation through NPM
Ensure **Neovim β₯ 0.11** (0.12 recommended) and **Node.js** are installed on
your machine, then:
```shell
npx colson-nvim@latest
```
### Requirements
| Dependency | Why | Required |
| ---------------------------- | ---------------------------------------- | -------- |
| Neovim β₯ 0.11 | Core editor (0.12 recommended) | β
|
| git | Plugin manager + plugin installs | β
|
| Node.js β₯ 18 | LSP servers, markdown preview, Copilot | β
|
| C compiler + make | Treesitter parsers, telescope-fzf-native | β
|
| tree-sitter CLI | Parser builds (treesitter `main` branch) | β
|
| ripgrep | Telescope live grep | β
|
| python + pynvim | UltiSnips (React snippets) | β
|
| JetBrainsMono Nerd Font | Icons & glyphs | β
|
| xclip / wl-clipboard (Linux) | System clipboard integration | β |
| jq, curl | HTTP REST client niceties | β |
π§ Arch Linux (click to expand)
```shell
sudo pacman -S neovim nodejs npm git base-devel cmake unzip ripgrep python-pynvim xclip
npm install -g tree-sitter-cli
```
π§ Debian / Ubuntu (click to expand)
```shell
# Neovim from apt is often outdated - prefer the official release:
curl -LO https://github.com/neovim/neovim/releases/latest/download/nvim-linux-x86_64.tar.gz
sudo tar -C /opt -xzf nvim-linux-x86_64.tar.gz
echo 'export PATH="$PATH:/opt/nvim-linux-x86_64/bin"' >> ~/.bashrc
sudo apt install nodejs npm git build-essential cmake unzip ripgrep python3-pynvim xclip
npm install -g tree-sitter-cli
```
π§ Fedora / RHEL (click to expand)
```shell
sudo dnf install neovim nodejs git gcc gcc-c++ make cmake unzip ripgrep python3-neovim xclip
npm install -g tree-sitter-cli
```
π§ openSUSE (click to expand)
```shell
sudo zypper install neovim nodejs git gcc gcc-c++ make cmake unzip ripgrep python3-pynvim xclip
npm install -g tree-sitter-cli
```
π macOS (click to expand)
```shell
xcode-select --install # C toolchain (clang + make)
brew install neovim node git ripgrep
pip3 install pynvim
npm install -g tree-sitter-cli
```
Clipboard integration works out of the box via `pbcopy`/`pbpaste` β no extra
package needed.
π€ JetBrainsMono Nerd Font (click to expand)
Install the JetBrains Mono Nerd Font to render icons and language glyphs:
https://github.com/ryanoasis/nerd-fonts/releases/download/v3.2.1/JetBrainsMono.zip
On Arch: `sudo pacman -S ttf-jetbrains-mono-nerd` Β· on macOS:
`brew install --cask font-jetbrains-mono-nerd-font`
### First Launch
```shell
nvim
```
- lazy.nvim bootstraps automatically (if the installer didn't pre-clone it)
- All plugins restore to their **pinned commits** from `lazy-lock.json`
- Treesitter parsers compile in the background
- Mason installs language servers for the toolchains it detects on your machine
Give the first launch a couple of minutes, restart Neovim, and you're home. π‘
### For the latest pull, do:
```shell
npx colson-nvim@latest
```
If it's not the first time, then after each pull open Neovim and run:
```
:Lazy restore
```
That checks out every plugin at the exact commits shipped with the release β
the tested, known-good state. (The old `pac` flow still works too β
it now syncs through lazy.nvim under the hood.)
`NOTE`: Leader key for Neovim -> **SPACE**
## ποΈ Architecture
Distinguished-engineer discipline: declarations, configuration, and boot
orchestration live in separate, single-purpose layers.
```
~/.config/nvim/
βββ init.lua # Entry point (banner + delegation only)
βββ lazy-lock.json # Exact commit pins - reproducible installs
βββ lua/colson/
β βββ init.lua # Staged boot orchestrator (4 stages)
β βββ remap.lua # Leader + all keymaps (loads FIRST)
β βββ set.lua # Editor options
β βββ startup.lua # Startup behavior (dashboard-aware)
β βββ lazy.lua # lazy.nvim bootstrap + Packer shims
β βββ packer.lua # LEGACY reference (not loaded)
β βββ plugins/ # Plugin DECLARATIONS by domain
β βββ editor.lua # telescope, harpoon, snippets, ...
β βββ git.lua # fugitive, diffview, gitsigns, ...
β βββ lsp.lua # lsp-zero, treesitter, typescript-tools
β βββ java.lua # nvim-java, DAP, neotest
β βββ tools.lua # HTTP clients, markdown, AI assistants
β βββ ui.lua # dashboard, lualine, themes
βββ after/plugin/*.lua # Plugin CONFIGURATIONS (one file each)
```
Every plugin spec that was ever commented out in the Packer era is preserved
in the new domain modules β translated to lazy.nvim syntax so re-enabling
anything is a pure uncomment.
## π’ Built for Large-Scale Distributed Systems
This config is daily-driven against a ~95-microservice polyglot monorepo.
What that means for you:
- **Polyglot LSP auto-detection** β mason inspects the toolchains on your
machine (Go, Rust, Java, Python, Elixir, Scala, TS/JS, Terraform, Docker,
YAML, proto/gRPC via `pbls`, and more) and installs only the matching
language servers. No dead weight.
- **JVM tuned for monorepos** β jdtls runs with a 2gβ8g G1GC heap profile,
multi-JDK runtimes, Gradle/Maven root markers, and full DAP + neotest
integration.
- **tsserver at scale** β typescript-tools.nvim with separate diagnostic
server and configurable memory ceiling.
- **Monorepo-fast search** β telescope + ripgrep + compiled fzf native sorter.
- **Feedback under load** β fidget.nvim shows indexing progress; gitsigns has
a 40k-line file guard so giant generated files never lag the gutter.
## β Keeping Your Configuration Up-to-Date
I'm committed to consistently enhancing this Neovim setup with new features, optimizations, and additional plugins. To ensure you're making the most out of this dynamic configuration, I recommend checking for updates monthly!
As the configuration evolves, it's a good practice to sync your local repository with the latest changes. To do this, navigate to your Neovim configuration directory and run the following command:
```bash
cd ~/.config/nvim
git pull origin main
nvim +"Lazy restore" +q # align plugins with the shipped lockfile
```
Or simply re-run the installer: `npx colson-nvim@latest` (your existing config
is backed up automatically first).
## **Prerequisites: Neovim 0.11.0 or Higher**
Ensure a seamless experience by confirming your Neovim version meets the requirements. Execute the following command to check your Neovim version:
```bash
nvim --version
```
Upgrade to Neovim 0.11.0 or higher if needed (0.12.x is what this config is
verified against), and dive into an enhanced coding experience with this
dynamic configuration! π
## Table of Contents
- [β‘ TL;DR β One Command](#-tldr--one-command)
- [π What's New (July 2026)](#-whats-new-july-2026--the-future-proof-release)
- [π₯οΈ Dashboard β Start Screen](#%EF%B8%8F-dashboard--start-screen)
- [Installation through NPM](#installation-through-npm)
- [Requirements](#requirements)
- [First Launch](#first-launch)
- [For the latest pull, do:](#for-the-latest-pull-do)
- [ποΈ Architecture](#%EF%B8%8F-architecture)
- [π’ Built for Large-Scale Distributed Systems](#-built-for-large-scale-distributed-systems)
- [β Keeping Your Configuration Up-to-Date](#-keeping-your-configuration-up-to-date)
- [β¨ New Updated Zenful Look (COLSON NVIM)](#-new-updated-zenful-look-colson-nvim)
- [@ Neovim on Arch Linux](#-neovim-on-arch-linux)
- [π NEW ZEN LOOK (Colson NVIM, March 19th, 2025)](#-new-zen-look-colson-nvim-march-19th-2025)
- [π NEW LOOK (Colson NVIM, December 5th, 2024)](#-new-look-colson-nvim-december-5th-2024)
- [New Modern Look, September 2024 π](#new-modern-look-september-2024-)
- [Latest Fresh Look, July 2024 :)](#latest-fresh-look-july-2024-)
- [@ Neovim on macOS](#-neovim-on-macos)
- [2023/Early 2024 Look](#2023early-2024-look)
- [π₯ COOL NEW Discord Presence for Neovim (April, 2025)](#-cool-new-discord-presence-for-neovim-april-2025)
- [Introduction](#introduction)
- [π Old Look (COLSON NVIM)](#-old-look-colson-nvim)
- [Installation (Manual, without npm)](#installation-manual-without-npm)
- [Features](#features)
- [Global Key Bindings](#global-key-bindings)
- [Normal Mode Key Bindings](#normal-mode-key-bindings)
- [**Telescope** Integration](#telescope-integration)
- [TELESCOPE GREP Search](#telescope-grep-search)
- [π₯ NEW UPDATES](#-new-updates)
- [**Bufferline**](#bufferline)
- [**JSX/TSX \& Other Languages Commenting**](#jsxtsx--other-languages-commenting)
- [**Discord Presence**](#discord-presence)
- [Emmet (For HTML/JSX Autocompletion)](#emmet-for-htmljsx-autocompletion)
- [Tailwind CSS IntelliSense](#tailwind-css-intellisense)
- [Gen Lorem Ipsum](#gen-lorem-ipsum)
- [Code Fold](#code-fold)
- [Live Server](#live-server)
- [System Clipboard Copy](#system-clipboard-copy)
- [π React Snippets Autocompletion](#-react-snippets-autocompletion)
- [Git Diff View π](#git-diff-view-)
- [𧬠Git Hunk Signs (gitsigns)](#-git-hunk-signs-gitsigns)
- [π°οΈ HTTP REST Client](#οΈ-http-rest-client)
- [πͺ HTTP Client](#-http-client)
- [π Syncing Plugin Updates (lazy.nvim)](#-syncing-plugin-updates-lazynvim)
- [β
Git Merge Conflicts Resolver](#-git-merge-conflicts-resolver)
- [π Telescope π₯](#-telescope-)
- [π€ Augment Code β Enterprise Grade Configuration](#-augment-code--enterprise-grade-configuration)
- [π€ Github Copilot Integration](#-github-copilot-integration)
- [π **HTTP REST Client for Engineers**](#-http-rest-client-for-engineers)
- [π Markdown Preview β¨](#-markdown-preview-)
- [π©Ί Troubleshooting](#-troubleshooting)
- [Cool Pre-Configured Themes](#cool-pre-configured-themes)
**DEMO Screenshot**
## β¨ New Updated Zenful Look (COLSON NVIM)
## @ Neovim on Arch Linux
### π NEW ZEN LOOK (Colson NVIM, March 19th, 2025)
### π NEW LOOK (Colson NVIM, December 5th, 2024)
### New Modern Look, September 2024 π
### Latest Fresh Look, July 2024 :)
---
## @ Neovim on macOS
### 2023/Early 2024 Look
## π₯ COOL NEW Discord Presence for Neovim (April, 2025)
## Introduction
This Neovim configuration is a powerhouse of productivity enhancements and aesthetics. I've curated a selection of plugins, key bindings, and themes to provide a versatile and delightful text-editing experience. Whether you're a developer, writer, or anyone in need of a robust text editor, this setup has got you covered.
### π Old Look (COLSON NVIM)
## Installation (Manual, without npm)
To embark on this Neovim journey, follow these steps:
1. Clone this repository's `nvim` folder to your Neovim configuration directory
(back up any existing `~/.config/nvim` first!):
```shell
git clone https://github.com/colson0x1/colson-nvim /tmp/colson-nvim
cp -r /tmp/colson-nvim/nvim ~/.config/nvim
```
2. Launch Neovim:
```shell
nvim
```
lazy.nvim bootstraps itself and restores all plugins from `lazy-lock.json`
automatically β no manual plugin-manager installation step anymore. π
3. Install JetBrainsMono Nerd Font:
- Install the regular JetBrains Mono version to support Unicode and Programming Languages Icons in the Neovim IDE!
https://github.com/ryanoasis/nerd-fonts/releases/download/v3.2.1/JetBrainsMono.zip
Now, you're all set to unleash the power of this Neovim configuration!
## Features
### Global Key Bindings
#### Leader Key
- **``** serves as the leader key for most key bindings.
#### Netrw: File Explorer
- **`pv`**: Open a file explorer with **Netrw**.
#### NvimTree (Right window pane file explorer)
- **`e`**: Toggle NvimTree
**NOTE: Make sure NvimTree is Opened!**
- **`+`** - Increase the NvimTree (or current window) width by 5 columns.
- **`-`** - Decrease the NvimTree (or current window) width by 5 columns.
- **`fp`** - Manually set the width of the Project Pane.
##### Save Files
**`w`** - Save all open files.
##### Save and Exit Nvim
**`q`**: - Exit Neovim
**NEW Look!**
**Old Look**
#### Collaborative Editing (optional)
- **`vwm`**: Start a Vim-With-Me collaborative editing session.
- **`svwm`**: Stop a Vim-With-Me collaborative editing session.
> Requires the optional [vim-with-me](https://github.com/ThePrimeagen/vim-with-me)
> plugin β add it in `lua/colson/plugins/editor.lua` if you want this workflow.
#### Text Manipulation
- **`y`**: Yank to the system clipboard (normal & visual mode).
- **`Y`**: Yank from cursor to the end of the line.
- **`d`**: Delete without clobbering the yank register (normal & visual mode).
- **`p`**: Paste over a selection without losing the yanked text (visual mode).
- **`Ctrl+c`**: Exit insert mode.
#### Code Formatting
- **`f`**: Format code using LSP (Language Server Protocol).
- Even awesome: **`:w`** triggers Prettier for code formatting!
#### Navigation
- **``** and **``**: Navigate through the quickfix list.
- **`k`** and **`j`**: Navigate through the location list.
#### Search and Replace
- **`s`**: Search & replace the word under the cursor across the file
(pre-fills a `:%s//gI` command β just edit the replacement and hit Enter).
- **`fs`**: Interactive string grep across the project (Telescope).
### Normal Mode Key Bindings
#### Line Manipulation
- **`J`** and **`K`** (visual mode): Move the selected lines down / up β
reindenting as they go.
- **`J`** (normal mode): Join the line below without moving the cursor.
#### Scrolling
- **``** and **``**: Half-page down / up β cursor stays centered.
- **`n`** and **`N`**: Next / previous search result β centered on screen.
#### Code Navigation
- **`ds`** or **`gd`**: Go to definition (Normal Mode).
- **`gf`**: Go to file under cursor.
- **`vca`**: Code actions.
- **`vrr`**: Show references.
- **`vrn`**: Rename symbol.
- **``** (insert mode): Signature help.
#### Saving & Quitting
- **`w`**: Write all open files (`:wall`).
- **`q`**: Write all and quit Neovim (`:wqa`).
- **`x`**: Make the current file executable (`chmod +x`).
#### Git Integration
- **`gs`**: Git status (Telescope).
- **`gc`**: Browse Git commits (Telescope).
- **`gb`**: Switch Git branches (Telescope).
- **`gf`**: Find Git-tracked files (Telescope).
- **`:Git `**: Full Git via Fugitive (`:Git commit`, `:Git push`, `:Git log`, ...).
#### Harpoon Integration
- **`Ctrl+e`**: Harpoon open quick list.
- - **`a`**: Harpoon add buffer.
- **`Ctrl+t and Ctrl+h`**: Harpoon toggle buffer.
#### LSP Integration
- **`Shift+k`**: LSP hover.
- **`Ctrl+n`**: LSP toggle next in autocompletion.
- **`Ctrl+p`**: LSP toggle previous in autocompletion.
- **`Ctrl+k or Ctrl+y`**: LSP select in autocompletion.
- View Diagnostic Errors: **`dd` or `sd` or `vd`**
### **Telescope** Integration
- **`pf`**: Find files in the current directory.
NOTE: **``** is **SPACE**
### TELESCOPE GREP Search
Search by keyword in files!
- **`ps`**: Live grep files.
> β‘ Telescope now runs with **telescope-fzf-native** β a compiled C fuzzy
> sorter. Fuzzy matching stays instant even on monorepo-scale file counts.
## π₯ NEW UPDATES
### **Bufferline**
To enable bufferline (Tab based file buffer like VSCode), Go to:
`$ ~/.config/nvim`
Open nvim: `$ nvim .`
Navigate to `lua/colson/plugins/ui.lua` and uncomment the `Bufferline` spec.
After that, write `:w` and run `:Lazy sync`.
Now you're good to go!
- **`h`**: Goes to next tab.
- **`g`**: Goes to prev tab.
- **`btl`**: Move tab left.
- **`btr`**: Move tab right.
- **`bd`**: Delete current tab.
- **`bcl`**: Delete all tabs on left hand side.
- **`bcr`**: Delete all tabs on right hand side.
- **`abc`**: Close all tabs except currently opened one.
### **JSX/TSX & Other Languages Commenting**
#### **@ Commenting in Normal Mode**
- **`gcc`** - Toggles the current line using `linewise` comment.
- **`gbc`** - Toggles the current line using `blockwise` comment.
- **`[count]gcc`** - Toggles the number of line given as a prefix count
using `linewise` comment.
- **`[count]gbc`** - Toggles the number of line given as a prefix count
using `blockwise` comment.
- **`gc[count]{motion}`** - Toggles the region using `linewise` comment.
- **`gb[count]{motion}`** - Toggles the region using `blockwise` comment
#### **@ Commenting in Visual Mode**
- **`gc`** - Toggles the region using `linewise` comment.
- **`gb`** - toggles the region using `blockwise` comment.
### **Discord Presence**
- Open discord first and then, open your workspace from terminal: `nvim .`
### Emmet (For HTML/JSX Autocompletion)
- **`!`** To generate HTML standard boilerplate
- **`.app-header`**: Creates `div` with `classname` of `app-header`.
- **`#root`**: Creates `div` with `id` of `root`.
- **`.flex.color-blue-600`**: Creates `div` with `classnames` - `flex color-blue-600`.
- **`div`**: Creates `div` element.
- **`nav>ul>li*2`**: Creates
```js
```
- **`p+span**: Creates
```js
```
- **`.className`**: Creates `div` with `prop` `className` which can be useful for styling with css modules, tailwind or mixing with style components.
#### Normal Mode Tag Manipulation: tsx/jsx/html
- `vit`: Selects everything **inside the tag**, excluding the tags themselves.
- `vat`: Selects everything **including the tag** (inner and outer).
- `cit`: Deletes everything inside the tag and starts insert mode.
- `dit`: Deletes everything inside the tag without entering insert mode.
- `dat`: Deletes the tag and its contents.
### Tailwind CSS IntelliSense
- Use **``** to select when you use tailwind: Ex when you type `text-` in `className='text-'`, you get autocompletion!
- Use **` The `lorem.nvim` spec ships disabled β uncomment it in
> `lua/colson/plugins/tools.lua`, run `:Lazy sync`, and the pre-wired config
> in `after/plugin/loremipsum.lua` picks it up automatically.
### Code Fold
- To use code folding: First go to `Visual Line Mode` using `Shift+v`.
After that use `j` or `k` to select block of code.
Now use: `zf` to fold code.
To unfold the code, go to the code fold line and use: `zo` to open the code fold.
### Live Server
- First install live server globally: `sudo npm install -g live-server`
- Now inside `Neovim`: Go to `index.html` and on `Normal Mode`, type:
`:LiveServerStart` to start the server and `:LiveServerStop` to stop the server.
### System Clipboard Copy
First install `xclip` on your machine in order for the configurations to work
(Linux only β macOS works out of the box):
```
$ sudo pacman -S xclip # Arch
$ sudo apt install xclip # Debian/Ubuntu
$ sudo dnf install xclip # Fedora
```
Then open any workspace with `nvim .` in `Tmux` environment. Now you're ready to go!
- NORMAL OR VISUAL MODE: **`y`** - Copies to system clipboard.
- NORMAL MODE: **`Y`** - Copies text from cursor to the end of the line to the system clipboard.
## π React Snippets Autocompletion
### Ultisnips Dependency Installation
For this to work, the main package depends upon this dependency `Ultisnips`
which requires `pynvim` installed on your machine.
First, let's verify if `python3` support is enabled inside your `nvim` environment.
```
cd ~/.config/nvim
```
```
nvim .
```
In normal mode, type:
```
:echo has('python3')
```
If it returns 1, we're good to go else we need to install the dependencies to enable the support inside the neovim environment.
Here's how to do it on **Arch Linux**:
```
$ sudo pacman -S base-devel cmake unzip
$ sudo pacman -S python-pynvim
```
`NOTE`: Make sure to use the package manager based on your distribution!!
- On **Arch-based** distros:
```bash
sudo pacman -S
```
- On Debian-based distros:
```bash
sudo apt install
```
- On Red Hat-based distros:
```bash
sudo yum install
```
**For macOS:**
```bash
brew install python3
pip3 install pynvim
```
Now, again open Neovim and verify we've got access to `python3` inside the
`neovim` environment. This time, it should return `1` aka OKAY!
Now, make sure you're synced with my latest configuration!
```
$ cd ~/.config/nvim
```
```
nvim .
```
Then run:
```
:Lazy restore
```
Yay, finally now we should be able to use `React Snippets`!
### π₯ React Snippets Guide
> Use **``** after you type the trigger code!
#### Functional Components
| Trigger Code | What it does |
| ------------ | ------------------------------------------ |
| `fce` | `Function Component Export` |
| `fcde` | `Function Component Default Export` |
| `sfce` | `Simple Function Component Export` |
| `sfcde` | `Simple Function Component Default Export` |
| `useS` | `useState` |
| `useE` | `useEffect` |
| `useEA` | `useEffect async` |
| `useC` | `useContext` |
| `useRed` | `useReducer` |
| `useCB` | `useCallback` |
| `useM` | `useMemo` |
| `useR` | `useRef` |
| `useI` | `useImperativeHandle` |
| `useL` | `useLayoutEffect` |
| `useDV` | `useDebugValue` |
| `useT` | `useTransition` |
#### Class Components
| Trigger Code | What it does |
| ------------ | ----------------------------------------- |
| `rce` | `React Class Component Export` |
| `rcep` | `React Class Export with Prop interface` |
| `rceps` | `React Class Export with Props and State` |
| `rcc` | `React Class Component` |
| `rcon` | `React Class Constructor` |
| `spt` | `Static PropTypes` |
| `sdp` | `Static Default Props` |
| `sdpt` | `Static Default Props Typed` |
| `cdm` | `Component Did Mount` |
| `cdu` | `Component Did Update` |
| `cdc` | `Component Did Catch` |
| `cwum` | `Component Will Unmount` |
#### General Redux + Redux Toolkit
| Trigger Code | What it does |
| ------------ | ------------------------ |
| `useDS` | `useDispatch` |
| `useSL` | `useSelector` |
| `cs` | `createSlice` |
| `ecs` | `export createSlice` |
| `cpr` | `create prepare reducer` |
| `cat` | `createAsyncThunk` |
### π― TypeScript/JavaScript Engine: Cool Features
- **@ sorts and removes unused imports: `oi` or `soi`**
- **@ sorts imports: `si`**
- **@ removes unused imports: `ui` or `ri`**
- **@ adds imports for all statements that lack one and can be imported: `ai`**
- **@ fixes all fixable errors: `fe`**
- **@ goes to source definition (available since TS v4.7): `d`**
- **@ allow to rename current file and apply changes to connected files: `r` or `rn` or `rf`**
- **@ find files that reference the current file (available since TS v4.2): `fr`**
---
## Git Diff View π
These keymaps facilitate easy navigation and management of diffs in your codebase!
| Key Mapping | Action |
| ---------------- | ------------------------ |
| **`do`** | Open diff view |
| **`dc`** | Close diff view |
| **`df`** | Toggle file panel |
| **`dh`** | Focus file panel |
| **`dr`** | Refresh files |
| **`dp`** | Previous file entry |
| **`dn`** | Next file entry |
| **`dt`** | Select entry |
| **`dh`** | Open file history panel |
| **`dl`** | Close file history panel |
---
## 𧬠Git Hunk Signs (gitsigns)
Line-level change indicators live in the gutter β additions, changes, and
deletions at a glance, tuned with a 40k-line guard so huge generated files
never lag. No new keymaps were added (all your `g*` bindings are
untouched); drive it with commands:
| Command | Action |
| ------------------------------------- | -------------------------------- |
| `:Gitsigns preview_hunk` | Preview the hunk under cursor |
| `:Gitsigns reset_hunk` | Revert the hunk under cursor |
| `:Gitsigns blame_line` | Blame the current line |
| `:Gitsigns toggle_current_line_blame` | Toggle inline blame virtual text |
| `:Gitsigns diffthis` | Diff buffer against the index |
---
## π°οΈ HTTP REST Client
### Keymaps
| **Action** | **Key Mapping** |
| ---------------------------- | ---------------- |
| Send HTTP request | **`rr`** |
| Preview HTTP request | **`rp`** |
| Re-run last HTTP request | **`rl`** |
| Toggle environment variables | **`re`** |
### Key Mapping Explanation
- **`rr`**: Sends the HTTP request located at the cursor position. Useful for quickly testing endpoints without leaving the editor.
- **`rp`**: Previews the HTTP request that will be sent. This is beneficial for verifying the request structure and headers before execution.
- **`rl`**: Re-runs the last executed HTTP request. This saves time when you need to test the same endpoint multiple times.
- **`re`**: Toggles environment variables from a `.env` file, allowing you to manage configurations effectively.
## Usage Example
Hereβs an example of how to use **HTTP REST Client** in your workflow:
1. **Open a new buffer** in Neovim.
2. **Write your HTTP request** in the format supported in either one of these extension - **`.http`** or **`.rest`** . For example:
**API.http**
```http
POST http://localhost:3000/api/v1/users
Content-Type: application/json
{
"name": "Colson",
"currentYear": "2026",
"age": "25"
}
```
3. **Place the cursor** anywhere within the request.
4. Press `rr` to **send the request**.
5. Check the response in a split window.
---
## πͺ HTTP Client
This requires two dependencies: `pynvim` and `requests` library. Make sure these two dependencies are installed on your machine for it to work!
### pynvim Bindings:
- Install with `pip`:
```bash
pip install pynvim
```
- On Arch-based distros:
```bash
sudo pacman -S python-pynvim
```
- On Debian-based distros:
```bash
sudo apt install python3-pynvim
```
- On Red Hat-based distros:
```bash
sudo yum install python-pynvim
```
### requests Library:
- Install with `pip`:
```bash
pip install requests
```
- On Arch-based distros:
```bash
sudo pacman -S python-requests
```
- On Debian-based distros:
```bash
sudo apt install python3-requests
```
- On Red Hat-based distros:
```bash
sudo yum install python-requests
```
### β‘ Execute Network Request
Use the extension **`.http`** to run HTTP API Requests!
1. Go to the `.http` file.
2. To initiate a network request, execute: **`:Http`**
3. To terminate the current request, execute: **`:HttpStop`**
> Note: **`api`** is bound to the Resty client (see
> [HTTP REST Client for Engineers](#-http-rest-client-for-engineers)) β the
> recommended day-to-day request runner.
## π Syncing Plugin Updates (lazy.nvim)
Plugin management now runs on **lazy.nvim** β with full backwards
compatibility for the old Packer muscle memory:
| Command / Keymap | Action |
| ---------------- | ------------------------------------------------------------ |
| `:Lazy` | Open the lazy.nvim UI |
| `:Lazy restore` | Check out every plugin at the pinned commit (lazy-lock.json) |
| `:Lazy sync` | Install missing + update all + clean unused |
| `:Lazy update` | Update plugins and refresh the lockfile |
| `:Lazy profile` | Startup time profiling per plugin |
| `po` | Muscle-memory shim β `:Lazy sync` (was `:PackerSync`) |
| `pac` | Source current file + sync (works exactly like before) |
| `:PackerSync` | Compat shim β `:Lazy sync` |
| `:PackerInstall` | Compat shim β `:Lazy install` |
| `:PackerStatus` | Compat shim β `:Lazy home` |
> π **Golden rule:** `:Lazy restore` = deterministic (the tested, pinned
> state). `:Lazy sync`/`update` = bleeding edge (rewrites the lockfile).
> When in doubt, restore.
## β
Git Merge Conflicts Resolver
| Key Mapping | Command | Action |
| ------------ | ------------------------- | ------------------------------------------ |
| `co` | `GitConflictChooseOurs` | Choose your changes (`ours`). |
| `ct` | `GitConflictChooseTheirs` | Choose incoming changes (`theirs`). |
| `cb` | `GitConflictChooseBoth` | Include both sides (`both`). |
| `c0` | `GitConflictChooseNone` | Discard both sides (`none`). |
| `cn` | `GitConflictNextConflict` | Jump to the next conflict. |
| `cp` | `GitConflictPrevConflict` | Jump to the previous conflict. |
| `cs` | `GitConflictListQf` | List all conflicts in the quickfix window. |
---
## π Telescope π₯
### Telescope Normal Mode Commands
| Keymap | Mode | Description |
| -------------------------- | ----------- | ------------------------------------ |
| `pf or ff` | Normal Mode | Find files in the project |
| `ps or fg` | Normal Mode | GREP Search: Search across all files |
| `fb` | Normal Mode | Switch between buffers |
| `fh` | Normal Mode | Open help tags |
| `fs` | Normal Mode | Interactive string search |
| `fd` | Normal Mode | View diagnostics for the workspace |
| `fw` | Normal Mode | Search workspace symbols |
| `fr` | Normal Mode | Find references to a symbol |
| `fi` | Normal Mode | Locate implementations |
| `fc` | Normal Mode | Quickly execute Neovim commands |
| `ft` | Normal Mode | Explore syntax tree using Treesitter |
| `gs` | Normal Mode | View Git status |
| `gc` | Normal Mode | Browse Git commits |
| `gb` | Normal Mode | Switch Git branches |
| `gf` | Normal Mode | Locate files tracked by Git |
### Telescope Insert Mode Commands
| Keymap | Mode | Description |
| ------- | ----------- | ------------------------- |
| `` | Insert Mode | Move to the next item |
| `` | Insert Mode | Move to the previous item |
| `` | Insert Mode | Close Telescope window |
| `` | Insert Mode | Select default item |
| `` | Insert Mode | Select horizontally |
| `` | Insert Mode | Select vertically |
---
## π€ Augment Code β Enterprise Grade Configuration
Augment understands your codebase. I've configured and optimized for engineers working on large enterprise applications. The configuration provides:
- **Precise workspace context:** Workspace folders are explicitly set (or autoβupdated) so that Augmentβs AI engine has full knowledge of your codebase.
- **Custom key mappings:** Quick keybindings for accepting AI suggestions, launching chat, and triggering enterprise workflows (e.g. code review and refactoring prompts).
- **User command aliases:** Short command aliases to quickly invoke Augment functions from the command line.
### Key Mappings
π Goto command: Use **`Ctrl+j`** to accept the suggested inline code completion!
| Mode | Key Binding | Command Executed | Description |
| ------ | ------------- | ------------------------------------------------------------------------------ | ---------------------------------------------------------------- |
| Insert | ` ` | `call augment#Accept()` | Accept the current inline suggestion. |
| Insert | `` | `call augment#Accept("\n")` | Accept suggestion; if none, insert a newline. |
| Normal | `as` | `:Augment status` | Show Augment status (sign-in and workspace sync info). |
| Normal | `asi` | `:Augment signin` | Start the sign-in flow for Augment. |
| Normal | `ao` | `:Augment signout` | Sign out from Augment. |
| Normal | `ae` | `:Augment enable` | Globally enable AI suggestions. |
| Normal | `ad` | `:Augment disable` | Globally disable AI suggestions. |
| Normal | `al` | `:Augment log` | Open the Augment log for errors and debugging. |
| Normal | `ac` | `:Augment chat` | Start a chat session to ask questions about your codebase. |
| Normal | `an` | `:Augment chat-new` | Begin a new chat conversation (clears previous context). |
| Normal | `at` | `:Augment chat-toggle` | Toggle the visibility of the chat panel. |
| Normal | `acp` | `:Augment chat Please review the current function for potential improvements.` | Send a code review prompt for the current function. |
| Normal | `acf` | `:Augment chat Suggest refactoring for this block of code.` | Request refactoring suggestions for the selected code block. |
| Visual | `ac` | `:Augment chat` | Send selected text to Augment chat for contextβspecific queries. |
| Visual | `aq` | `:Augment chat` | Alternative visual mapping to chat with the selected text. |
### User Command Aliases
| Alias | Executes Command | Description |
| -------------- | --------------------- | --------------------------------------- |
| `:AStatus` | `Augment status` | Display Augmentβs current status. |
| `:ASignin` | `Augment signin` | Launch the signβin process. |
| `:ASignout` | `Augment signout` | Sign out of Augment. |
| `:AEnable` | `Augment enable` | Enable AI suggestions globally. |
| `:ADisable` | `Augment disable` | Disable AI suggestions globally. |
| `:ALog` | `Augment log` | View Augmentβs log output. |
| `:AChat` | `Augment chat` | Open a chat session for code questions. |
| `:AChatNew` | `Augment chat-new` | Start a new chat conversation. |
| `:AChatToggle` | `Augment chat-toggle` | Toggle the chat panel display. |
### Workspace Configuration & Auto-Update
Optional since I've configured Augment to autodetect current working directory opened with **`$ nvim .`**.
| Feature | Behavior | Description |
| ------------------------ | ------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Workspace Folders | `vim.g.augment_workspace_folders` set via `get_workspace_folders()` | Defines which project directories are indexed by Augment. Uses the `ENTERPRISE_WORKSPACES` env variable (colon-separated) or defaults to the current directory. |
| Auto-Update on DirChange | `DirChanged` autocmd triggers `update_workspace()` | Automatically adds new workspace folders when you change directories in Neovim, ensuring up-to-date context. |
---
## π€ Github Copilot Integration
π Copilot for code completion.
| Mode | Key Mapping | Command/Action | Description |
| ------ | ------------- | ------------------------ | ---------------------------------- |
| Normal | `csi` | `:Copilot setup` | Authenticate and enable Copilot |
| Normal | `cd` | `:Copilot disable` | Disable Copilot inline suggestions |
| Normal | `ce` | `:Copilot enable` | Enable Copilot inline suggestions |
| Normal | `cso` | `:Copilot signout` | Sign out of GitHub Copilot |
| Normal | `cs` | `:Copilot status` | Check the Copilot status |
| Insert | `j ` | `copilot#Accept("")` | Accept the current suggestion |
| Insert | `cn` | `copilot#Next()` | Cycle to the next suggestion |
| Insert | `cp` | `copilot#Previous()` | Cycle to the previous suggestion |
Note: Either enable **Augment** or **Copilot**, not both at the same time!
---
## π **HTTP REST Client for Engineers**
I've integrated a high-performance, enterprise-grade HTTP REST client plugin for Neovim written entirely in Lua. This configuration is designed for large-scale web application microservices and large code basesβideal for software engineers at major tech companies or startups.
### Features
- **Dynamic Environment Integration:**
Automatically retrieves dynamic variables (such as service endpoints, auth tokens, and database URLs) from environment variables, shell commands (with caching), or input prompts.
- **Inline Configuration Overrides:**
Customize behavior on a per-request basis using inline `@cfg` directives in your HTTP files.
- **Rich Response Views:**
Display HTTP response details (body, headers, and additional HTTP info) with dedicated result pane settings.
- **Advanced Scripting:**
Execute inline Lua scripts as post-request hooks to process responses and set global variables.
- **Extensive Logging:**
Enterprise-grade debugging with verbose log levels for comprehensive troubleshooting.
- **Telescope Integration:**
Use Telescope to easily select and register dotenv files.
**Supported Neovim Versions:**
- Latest stable (0.12.x β what this config is verified against)
- 0.11.x
### Dependencies:
- `curl` (mandatory)
- `jq` (optional, recommended for JSON formatting)
- `nvim-telescope/telescope.nvim` (optional, for dotenv selection)
- `hrsh7th/nvim-cmp` (optional, for auto-completion)
### HTTP File Syntax Overview
When writing your HTTP request definitions (saved as `.http` or `.resty` files), you can leverage:
- **Variable Declarations:**
- Global: `@[variable]=value`
- Dynamic (environment, shell command, prompt):
- `@hostname = {{$HOSTNAME}}`
- `@hostname = {{> ./myscript.sh}}` (non-cached)
- `@hostname = {{>> ./myscript.sh}}` (cached)
- `@hostname = {{:prompt}}`
- **Configuration Variables:**
Override defaults with:
`@cfg.timeout = 2000`
`@cfg.check_json_body = true`
- **Request Definition:**
Specify HTTP method, URL (e.g., using dynamic `{{hostname}}`), headers, and body.
- **Inline Lua Scripting Hooks:**
Use `# @lang=lua` above Lua script blocks to process responses.
```http
# @lang=lua
> {%
local body = ctx.json_body()
if body.token then
ctx.set("login.token", body.token)
end
--%}
```
- **Favorites:**
Mark requests with delimiters (e.g., `### #my favorite`) to easily recall them via Telescope.
### **Commands & Key Mappings Table**
| **User / Alias** | **Command / Key Mapping** | **Description** |
| --------------------------- | ------------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
| **Run Request** | `api` β `:Resty run` | Runs the HTTP request under the cursor or selected in visual mode. |
| **Open Result Pane** | `apo` β `:Resty open` | Opens the response/result pane in a new window. |
| **Run Last Request** | `apl` β `:Resty last` | Re-runs the last successfully executed request. |
| **Show Favorites** | `apf` β `:Resty favorite` | Displays a Telescope view listing all requests marked as favorites. |
| **Run Specific Favorite** | `apm` β `:Resty favorite my favorite` | Runs the favorite request named "my favorite", regardless of cursor location. |
| **Edit Logs File** | `aplgs` or `apil` β `:Resty logs` | Opens the log file to review detailed execution logs. |
| **Edit Cookies File** | `aprc` β `:Resty cookies` | Opens the cookies file used for session management. |
| **Show Environment File** | `apre` β `:Resty env show` | Displays the dotenv file currently registered with the active HTTP file. |
| **Select Environment File** | `aprs` β `:Resty env select` | Launches a Telescope view to select and register a dotenv file. |
| **Set Environment File** | `aprt` β `:Resty env set {path}` | Registers a specific dotenv file for the current HTTP file by appending the file path after the command. |
---
## π Markdown Preview β¨
**Markdown preview** transforms your **plain markdown text** into **beautifully rendered
documents** in **real time**. It offers live updates as you type, supports syntax
highlighting for code blocks, and allows customization with themes and styles.
This feature enhances your writing **experience** by providing **immediate visual
feedback**, making it easier to create well-formatted content.
### Commands & Key Mappings
| Key Mapping | Command | Command |
| ------------ | ------------------------ | ---------------------------------- |
| `mp` | `:MarkdownPreview` | Start the Markdown preview |
| `ms` | `:MarkdownPreviewStop` | Stop the Markdown preview |
| `mt` | `:MarkdownPreviewToggle` | Toggle the Markdown preview on/off |
---
## π©Ί Troubleshooting
Health check first
```
:checkhealth
:Lazy
:Mason
:messages
:LspInfo
```
`:checkhealth lazy` validates the plugin manager; `:Lazy profile` shows
per-plugin startup cost.
Plugins in a weird state
```
:Lazy restore
```
restores every plugin to the exact pinned commit from `lazy-lock.json`.
Nuclear option:
```bash
rm -rf ~/.local/share/nvim/lazy
nvim # bootstraps and restores everything fresh
```
Treesitter parser errors
The treesitter `main` branch builds parsers with the `tree-sitter` CLI:
```bash
npm install -g tree-sitter-cli
```
then inside Neovim: `:TSUpdate`
LSP server missing
`:Mason` and install what you need. Servers are auto-detected from the
toolchains present on your machine β install the toolchain (e.g. `go`,
`rustc`, `rebar3`) and restart Neovim to get its LSP automatically.
Telescope grep returns nothing
Install ripgrep (`rg`) β see the Requirements table above.
---
## Cool Pre-Configured Themes
The themes are configured already but I've commented out rest. Feel free to
explore these themes in `lua/colson/plugins/ui.lua` and uncomment the one
that resonates with your taste!
Preconfigured themes:
#### **@ Github Themes** - Has flavors
#### **@ Catppuccin Theme** - Has flavors
#### **@ Rose Pine Theme** - Has flavors
#### **@ Jetbrains IDE Theme**
#### **@ MoonFly Theme**
#### **@ One Dark Theme** - Has flavors
#### **@ Nord Theme** - Has flavors
#### **@ Tokyo Night Theme** - Has flavors π
END:
May your coding journey with Neovim be nothing short of stellar! π
Peace! π
