Ecovim: Frontend Neovim Config

A non-minimal Neovim config built to work most efficiently with Frontend Development.

✨ Features

🤖 AI & Assistance

• Avante - Claude-powered coding agent
• GitHub Copilot - AI pair programmer
• Copilot NES - Next Edit Suggestions
• Opencode - OpenAI integration
• MCPHub - Model Context Protocol

🎨 UI & Experience

• Tokyonight theme
• Custom galaxyline statusline
• Snacks.nvim - explorer, picker, notifications
• tiny-glimmer - highlight animations
• tiny-inline-diagnostic - enhanced diagnostics
• todo-comments - TODO highlighting
• which-key - keybinding helper

💻 Frontend Development

• TypeScript, React, Next.js, Vue
• TailwindCSS with color highlighting
• blink.cmp - completion engine
• boundary.nvim - RSC 'use client' markers
• NPM package info in package.json
• Jest testing & coverage
• treesj - smart split/join lines

🔧 DevOps & Tools

• Docker LSP support
• Terraform & HCL
• YAML language server
• yazi.nvim - terminal file manager
• harpoon - quick file navigation
• multicursor - multi-cursor editing
• Monorepo-aware root detection (pnpm, Turborepo, Nx, Lerna, Rush)

🔍 Code Quality

• Native LSP via mason.nvim
• SchemaStore - 500+ JSON/YAML schemas
• inc-rename - live-preview rename
• symbol-usage - reference counts
• lazydev - Neovim Lua API completions
• grug-far - search & replace
• text-case - case conversion
• scissors - snippet editing

🌳 Git Integration

• Lazygit terminal UI
• gitsigns - inline diffs
• diffview - diff viewer
• octo.nvim - GitHub PRs & issues
• Custom git blame
• Side blame panel

📘 TypeScript & React Features

EcoVim ships with deep TypeScript and React/Next.js integration out of the box:

Feature	Plugin	Description
Type checking	tsc.nvim	Async project-wide tsc --noEmit with quickfix
Error translation	ts-error-translator	Human-readable TypeScript errors
RSC boundaries	boundary.nvim	Visualize 'use client' directive usage in Next.js
Template strings	template-string	Auto-convert to template literals on ${}
Tailwind values	tw-values	Preview resolved Tailwind class values
Tailwind fold	tailwind-fold	Fold long Tailwind class strings
Smart increment	dial.nvim	Cycle true/false, const/let, increment dates
Reference counts	symbol-usage	Show usage counts above functions/components
Live rename	inc-rename	Preview LSP rename as you type
JSON/YAML schemas	SchemaStore	Auto-schemas for tsconfig, package.json, etc.
Lua API completions	lazydev	Neovim Lua API types for vim.*, plugins

🚀 Performance

• Startup time: ~90ms (measured on M1 Mac)
• Lazy loaded: All plugins via lazy.nvim

Screenshots

Dashboard

Overview

Some of screenshots can be old

TailwindCSS with nvim-cmp

Which Key Menu

Lazygit

Git Side Blame

---

☕ Support

If you enjoy using EcoVim and would like to support its development:

Your support helps maintain and improve EcoVim. Thank you! 🙏

Installation

Just clone GitHub repo into ~/.config/nvim.

Prerequisities

• Make sure you have installed the latest version of Neovim v0.11+ (nightly is preferred).
• Have wget, curl, unzip, git, make, pip, python, npm, node, luarocks, fd, ripgrep and cargo installed on your system. You can check if you are missing anything with :checkhealth command.
• Have any nerd font installed. Fira Code has been used in screenshots. You can download it from nerdfonts.com.

After install configuration:

1. Selected treesitter Languages are installed by default. To check it run :TSInstallInfo. Make sure to run :TSInstall <lang> for specific language you want to install.
2. LSP servers are enabled by default. You can check installed LSP servers by :Mason command.

Configuration

All customization is done in lua/config/user.lua. This file is gitignored and won't cause merge conflicts when updating!

Quick Start

# Copy the example file
cp lua/config/user.lua.example lua/config/user.lua

# Edit your personal config
nvim lua/config/user.lua

Quick Customization Examples

-- lua/config/user.lua

-- Change colorscheme
EcoVim.colorscheme = "tokyonight-storm"

-- Add custom LSP servers
EcoVim.lsp.ensure_installed = { "rust_analyzer", "gopls" }

-- Override formatters
EcoVim.formatters = {
  javascript = { "prettierd" },
  typescript = { "prettierd" },
}

-- Add custom autocmds
EcoVim.autocmds.auto_save = {
  event = "FocusLost",
  pattern = "*",
  command = "silent! wa",
}

-- Override any plugin config (use repo name, e.g., "snacks.nvim")
EcoVim.plugin_overrides["snacks.nvim"] = function(_, opts)
  opts.picker.layout = "vertical"
end

-- Configure project directories (for <leader>pl project picker)
EcoVim.plugins.projects.dev = { "~/Projects", "~/Work" }

-- Rooter supports monorepo tools out of the box:
-- pnpm, Turborepo, Nx, Lerna, Rush
-- Add package.json back to rooter if you don't use monorepos
-- EcoVim.plugins.rooter.patterns = { ".git", "package.json" }

-- Toggle features on/off
EcoVim.lsp.format_on_save = true        -- Enable auto-format on save
EcoVim.lsp.inlay_hints = false           -- Disable inlay hints
EcoVim.lsp.typescript_server = "ts_ls"   -- Switch from tsgo to ts_ls
EcoVim.plugins.completion.ghost_text = false  -- Disable ghost text
EcoVim.plugins.git.blame_line = false    -- Disable inline git blame

-- Custom vim options
vim.opt.tabstop = 4
vim.opt.shiftwidth = 4

Full Configuration Options

Option	Type	Default	Description
colorscheme	string	"tokyonight-night"	Theme name
ui.font	table		GUI font settings
ui.float.border	string	"rounded"	Border style: "rounded", "single", "double", "shadow", "none"
lsp.ensure_installed	table	{}	Additional LSP servers to install via Mason
lsp.exclude	table	{ "copilot" }	LSP servers to not auto-enable
lsp.typescript_server	string	"tsgo"	TypeScript server: "tsgo" (fast, native) or "ts_ls" (classic)
lsp.servers	table	{}	Custom LSP server configurations
lsp.format_on_save	boolean	false	Auto-format on save (toggle at runtime with :LspToggleAutoFormat)
lsp.inlay_hints	boolean	true	Show inlay hints from LSP servers
formatters	table	{}	Override formatters per filetype
linters	table	{}	Override linters per filetype
autocmds	table		Add custom autocmds
plugin_overrides	table		Override any plugin configuration
plugins.ai.*.enabled	boolean	varies	Enable/disable AI plugins (avante, copilot, opencode)
plugins.completion.select_first_on_enter	boolean	false	Auto-select first completion item on Enter
plugins.completion.ghost_text	boolean	true	Show inline completion preview (ghost text)
plugins.git.blame_line	boolean	true	Show inline git blame on current line
plugins.rooter.patterns	table		Root detection patterns for vim-rooter
plugins.projects.dev	table	{ "~/Projects" }	Directories to scan for projects
plugins.projects.patterns	table	{ ".git" }	Patterns to detect project roots

Tips

• Runtime toggles -- Some options also have runtime commands: :LspToggleAutoFormat for format-on-save, :Gitsigns toggle_current_line_blame for git blame.
• Plugin overrides let you change ANY plugin's config without forking files. Use the plugin's GitHub repo name (e.g., "snacks.nvim", "blink.cmp"). Function overrides receive (plugin, opts) -- mutate opts directly, no need to return.
• Monorepo users -- EcoVim detects pnpm/Turborepo/Nx/Lerna/Rush roots automatically. The package.json is excluded from rooter patterns to prevent cwd from scoping to sub-packages.
• Non-monorepo users -- Add package.json back: EcoVim.plugins.rooter.patterns = { ".git", "package.json" }
• Border style -- EcoVim.ui.float.border controls ALL floating windows (hover, diagnostics, completion, signature help). Set it once and everything follows.
• See user.lua.example for the complete reference with all available options and inline documentation.

Updating EcoVim

Since your config is in user.lua (gitignored), you can safely update:

cd ~/.config/nvim
git pull

No merge conflicts with your personal settings!

For vim settings and new plugins

• Edit config/options.lua for vim options
• Create files in lua/plugins/ for new plugins

Keybindings

Space (SPC) is my Leader key.

Tip: Press SPC in normal mode to open the which-key menu and explore all available keybindings interactively.

File Explorer (Snacks)

Key Bindings	Description
<C-e>	Toggle Snacks file explorer
<D-e>	Toggle Snacks file explorer (macOS Cmd+E)

The Snacks explorer uses its own keybindings when focused. Press ? inside the explorer to see all available actions (create, rename, copy, delete, etc.).

Searching

Key Bindings	Description
<C-p>	Smart file finder (Snacks picker)
<S-p>	Live grep (Snacks picker)
s	Flash jump to any word
S	Flash treesitter selection
SPC s f	Find files
SPC s b	Find buffers
SPC s g	Git grep
SPC s o	Grep open buffers
SPC s h	Recent files
SPC s H	Command history
SPC s s	Search history
SPC s q	Quickfix list
SPC s c	Color schemes
SPC s d	Search dotfiles (nvim config)
SPC s t	Search TODOs
SPC s T	Search TODO/FIX/FIXME
]t	Next TODO comment
[t	Previous TODO comment

Working with LSP

Key Bindings	Description
gd	Go to definition
gr	Go to references
gy	Go to type definition
gi	Go to implementation
K	Hover documentation / peek fold
L	Signature help (normal & insert mode)
gl	Line diagnostics
]g	Next diagnostic
[g	Previous diagnostic
<C-Space> / SPC c a	Code action
SPC c f	Format document (LSP)
SPC c r	Rename symbol (live preview)
SPC c R	Rename file
SPC c d	Diagnostics list (Snacks picker)
SPC c t	Toggle format on save
SPC c u	Toggle symbol usage
SPC c m	Mason LSP manager
SPC c l i	LSP Info
SPC c l r	LSP Restart
SPC c l s	LSP Stop
SPC c l S	LSP Start
SPC s s	Document symbols
SPC s S	Workspace symbols

TypeScript / React (buffer-local)

These keybindings are available in TypeScript/JavaScript buffers:

Key Bindings	Description
SPC c e	Workspace errors (TSC)
SPC c i	Add missing imports
SPC c o	Organize imports
SPC c s	Sort imports
SPC c u	Remove unused imports
SPC c v	Show Tailwind CSS values
<C-a>	Smart increment (numbers, booleans, dates, const/let, &&/||, etc.)
<C-x>	Smart decrement

Formatting & Linting

Key Bindings	Description
SPC f	Format file (conform.nvim)
SPC f (visual)	Format selection
SPC l	Lint file (nvim-lint)

Working with Git

Key Bindings	Description
SPC g g	Lazygit
SPC g s	Git status (Snacks picker)
SPC g f	Git files (Snacks picker)
SPC g a	Git add current file
SPC g A	Git add all
SPC g b	Blame panel (git-blame)
SPC g m	Blame line (full commit)
SPC g d	Diff file history (diffview)
SPC g D	Diff view open
SPC g S	Diff view status
SPC g i	GitHub issues list (Octo)
SPC g p	GitHub pull requests list (Octo)
SPC g L	Copy git URL for selection (gitlinker)
]c	Next change hunk
[c	Previous change hunk
Hunk actions
SPC g h s	Stage hunk
SPC g h r	Reset hunk
SPC g h S	Stage buffer
SPC g h R	Reset buffer
SPC g h u	Undo stage hunk
SPC g h p	Preview hunk
SPC g h d	Diff hunk
SPC g h t	Toggle deleted
Git log
SPC g l a	Lazygit log (cwd)
SPC g l c	Lazygit current file history
SPC g l A	Git log (Snacks picker)
SPC g l C	File commits (Snacks picker)

Working with Project

Key Bindings	Description
SPC p w	Grep word under cursor in project (Snacks picker)
SPC p l	Switch between projects (Snacks picker)
Search & Replace (grug-far)
SPC p r r	Open search & replace
SPC p r a	Search & replace (ast-grep engine)
SPC p r w	Search & replace word under cursor
SPC p r W	Search & replace word under cursor in current file
SPC p r f	Search & replace in current file
Sessions
SPC p s s	Save current session
SPC p s l	Load session
SPC p s L	Load last session
SPC p s m	Session manager commands

AI & Agents

Key Bindings	Description
Copilot NES
<Tab>	Accept/navigate Copilot NES suggestion
Avante (when enabled)
SPC a a	Toggle Avante sidebar
Uses Avante default keybindings — see :h avante for full list
Opencode (when enabled)
SPC o	Opencode group (see which-key)
MCPHub
:MCPHub	Open MCP Hub

Debugging (DAP)

Key Bindings	Description
SPC d a	Continue
SPC d d	Continue
SPC d b	Toggle breakpoint
SPC d B	Conditional breakpoint
SPC d i	Step into
SPC d o	Step out
SPC d O	Step over
SPC d h	Evaluate expression
SPC d t	Terminate
SPC d u	Open DAP UI
SPC d c	Close DAP UI
SPC d w	Float watches
SPC d s	Float scopes
SPC d r	Float REPL

Pre-configured for Chrome, Node.js (pwa-node), Next.js server-side, Jest, Vitest, and Deno.

Testing (Jest / Neotest)

Available in TypeScript/JavaScript buffers:

Key Bindings	Description
SPC j j	Run nearest test
SPC j f	Run current file
SPC j l	Run last test
SPC j o	Open test output
SPC j i	Toggle info panel
SPC j s	Stop

Harpoon

Key Bindings	Description
SPC H	Add file to Harpoon
SPC h	Open Harpoon menu
SPC 1-4	Jump to Harpoon file 1-4
SPC [	Previous Harpoon file
SPC ]	Next Harpoon file

Multi-cursor

Using jake-stewart/multicursor.nvim:

Key Bindings	Description
<Up>	Add cursor above
<Down>	Add cursor below
SPC m	Add cursor at next match of word
<Left>	Rotate to next cursor
<Right>	Rotate to previous cursor
SPC x	Delete cursor
<C-LeftMouse>	Add/remove cursor with mouse
<C-q>	Toggle cursor
<Esc>	Clear cursors (or enable if disabled)
SPC g v	Restore cursors
SPC A	Align cursor columns

Window & Split Management

Key Bindings	Description
SPC v	Split right
SPC V	Split below
<C-h/j/k/l>	Move between splits
<A-h/j/k/l>	Resize splits
SPC SPC h/j/k/l	Swap buffer between splits
SPC =	Resize +5
SPC -	Resize -5
<C-\>	Previous split

Commenting

Key Bindings	Description
gcc	Toggle line comment
gbc	Toggle block comment
gc (visual)	Toggle comment
gcO	Add comment line before
gco	Add comment line after
SPC a c	Comment box

Table Mode / Alignment

Key Bindings	Description
ga (visual)	Aligns selection based on separator (comma, semi-colon, colon etc.) via mini.align
SPC t m	Toggle Table Mode (activates in markdown files via vim-table-mode)
SPC t i C	(Table Mode) Insert column before
SPC t i c	(Table Mode) Insert column after
SPC t d c	(Table Mode) Delete column
SPC t d r	(Table Mode) Delete row
SPC t s	(Table Mode) Sort table alphabetically

NPM Package Management

Available in package.json buffers:

Key Bindings	Description
SPC n s	Show package versions
SPC n h	Hide package versions
SPC n u	Update package
SPC n i	Install new package
SPC n d	Delete package
SPC n r	Reinstall dependencies
SPC n c	Change version

Zen Mode

Key Bindings	Description
SPC z	Zen mode
SPC Z	Zoom mode

Other Useful Bindings

Key Bindings	Description
<S-q>	Smartly close current buffer without breaking UI
<D-s>	Save file (macOS Cmd+S)
<D-q> / <D-w>	Close buffer (macOS Cmd+Q/W)
<D-d> / <D-u>	Half-page scroll down/up (macOS Cmd+D/U)
<D-i>	Jump forward in jumplist (macOS Cmd+I)
<C-o>	Jump to previous position in jumplist
<Tab> / <S-Tab>	Cycle through buffers
<BS>	Jump to first non-blank character
H	Jump to first non-blank character
v <CR>	Smartly select next treesitter subject (repeat to expand)
ciq	Change inside ANY quotes (`` or '' or "" etc.) via mini.ai
cib	Change inside ANY brackets ({} or [] or () etc.) via mini.ai
za	Toggle fold
zM	Close all folds
zR	Open all folds
zr	Open all folds except imports/comments
gJ	Smart join lines (treesitter-based via treesj)
~	Swap function arguments (treesitter)
gP	Print debug variable under cursor (printer.nvim)
<F12>	Toggle terminal
SPC q	Toggle quickfix list
SPC , / SPC .	Previous / next quickfix item
SPC y	Open Yazi file manager
SPC D	Open database (sqlit)
Snippets
SPC a s a	Add new snippet
SPC a s e	Edit snippet
EcoVim
SPC / /	Open dashboard
SPC / c	Open config
SPC / i	Manage plugins (Lazy)
SPC / u	Update plugins
SPC a n	Toggle line numbers
SPC a r	Toggle relative numbers
Treesitter textobjects
]] / [[	Next / previous JSX element
]f / [f	Next / previous function start
]m / [m	Next / previous class start
af / if	Select around / inside function
ac / ic	Select around / inside class

Check out the which-key menu and keymappings.lua for most used maps.

Performance

Measured on M1.

Ecovim started in 91.13ms

Description	Progress
lazy.nvim instead of packer
Better support for null-ls and local formatting
Better support to project word refactor
Support for nvim-dap debugger for React
Support ESLint & Prettier in Native LSP
Replace coc.nvim with Native LSP
Replace telescope.nvim with snacks.nvim picker
Replace nvim-tree with snacks.nvim explorer
Update statusline to support LSP diagnostics
Rewrite most config to lua
Support TailwindCSS with colors
Provide current screenshots
Create shell installer for Linux & MacOS
Better LSP configuration via EcoVim.lsp
Custom formatters/linters via EcoVim config
Plugin/keymap customization via EcoVim config