NvMegaChad

A batteries-included Neovim configuration built on NvChad. Designed with a minimal UI philosophy while providing comprehensive out-of-the-box support for modern development workflows.

Features

Minimal UI — Clean interface with thoughtfully designed key mappings
Multi-language Support — 18 languages with LSP, formatting, and linting
Debugging — Integrated DAP support for Go and Python
AI Assistant — Built-in Claude Code support via ACP
Markdown Preview — Live preview of Markdown files
Git Integration — Visual commit history and diff tools

Screenshots

Click to expand

AI Companion

Editor

Search

Git Commits

Debugger

Markdown Preview

Cheatsheet

Requirements

Dependency	Version	Notes
Neovim	0.12.0+	Required
Nerd Font	Any	Hack Nerd Font recommended
Ripgrep	Latest	For fuzzy finding
Claude Code	Latest	For AI assistant
claude-agent-acp	Latest	ACP bridge for Claude Code
Terraform	Latest	Optional, for Terraform support

Tip: On macOS, make install automates installation of the system dependencies, including the Tree-sitter CLI required to build parsers. Install Claude Code separately. The Makefile installer is macOS-only.

Installation

Quick Install

# Backup and remove existing config
mv ~/.config/nvim ~/.config/nvim.bak
mv ~/.local/share/nvim ~/.local/share/nvim.bak

# Clone and install
git clone https://github.com/le4ker/NvMegaChad ~/.config/nvim
cd ~/.config/nvim
make install
nvim

Try Without Overwriting Your Config

git clone [email protected]:le4ker/NvMegaChad ~/.config/le4ker/NvMegaChad
cd ~/.config/le4ker/NvMegaChad
make install
NVIM_APPNAME=le4ker/NvMegaChad nvim

Supported Languages

Language	LSP	Formatter	Linter	Debugger
Go	gopls	gofmt, goimports	golangci-lint	delve
Python	pyright	black, isort	pylint	debugpy
C/C++	clangd	clang-format	—	—
Lua	lua-language-server	stylua	—	—
Ruby	ruby-lsp	rubocop	rubocop	—
TypeScript/JavaScript	typescript-language-server	prettier	—	—
HTML/CSS/SCSS	html-lsp, css-lsp	prettier	—	—
JSON	json-language-server	prettier	—	—
GraphQL	—	prettier	—	—
YAML	yaml-language-server	prettier	—	—
Markdown	marksman	prettier	markdownlint	—
Bash	bash-language-server	shfmt	—	—
Dockerfile	dockerfile-language-server	—	—	—
Terraform	terraform-ls	terraform_fmt	tflint	—
TOML	taplo	taplo	—	—
Makefile	—	bake	checkmake	—
Vimscript	vim-language-server	—	—	—
SQL	—	sql-formatter	—	—

Development

Git Hooks Setup

This repository uses Conventional Commits. To enforce this on your local clone, run:

make hooks

This installs a commit-msg hook that validates your commit messages follow the format:

<type>(<scope>): <description>

Allowed types: feat, fix, docs, style, refactor, perf, test, build, ci, chore, revert

Examples:

feat(mappings): add new keybinding for terminal
fix(lsp): resolve null reference error
docs: update README

License

See LICENSE for details.

le4ker/nvmegachad

README