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

More screenshots

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:

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.
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

Done

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

Name		Name	Last commit message	Last commit date
Latest commit History 1,624 Commits
.install		.install
.screenshots		.screenshots
after/queries		after/queries
lua		lua
syntax		syntax
.ecovim.version		.ecovim.version
.gitignore		.gitignore
.versionrc.json		.versionrc.json
CHANGELOG.md		CHANGELOG.md
LICENSE		LICENSE
README.md		README.md
init.lua		init.lua
lazy-lock.json		lazy-lock.json

Folders and files

Latest commit

History

Repository files navigation

Ecovim: Frontend Neovim Config

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

✨ Features

🤖 AI & Assistance

🎨 UI & Experience

💻 Frontend Development

🔧 DevOps & Tools

🔍 Code Quality

🌳 Git Integration