# NvChad — Blazing Fast Neovim Framework with Beautiful UI

> Feature-rich Neovim configuration framework that provides solid defaults, a custom UI plugin, and a beautiful theme system while remaining fast and extensible.

## Install

Save in your project root:

# NvChad — Blazing Fast Neovim Framework with Beautiful UI

## Quick Use
```bash
git clone https://github.com/NvChad/starter ~/.config/nvim
nvim
```

## Introduction
NvChad is a Neovim configuration framework that ships its own UI plugin, theme infrastructure, and lazy-loaded plugin setup. It focuses on startup speed and visual polish while giving users a structured way to customize everything through a separate starter config.

## What NvChad Does
- Provides a base46 theme engine with 50+ built-in colorschemes
- Ships nvchad/ui for a custom statusline, tabufline, and dashboard
- Lazy-loads all plugins for sub-50ms startup times
- Manages LSP, completion, Treesitter, and telescope out of the box
- Separates framework code from user customizations via a starter template

## Architecture Overview
NvChad splits into two layers: the core framework (NvChad/NvChad) containing base46 themes and ui plugins, and a starter template (NvChad/starter) where users define their own plugins, LSP servers, and mappings. Lazy.nvim handles plugin management, and the base46 compile step pre-generates theme highlight groups for fast load times.

## Self-Hosting & Configuration
- Clone the NvChad starter template into ~/.config/nvim
- First launch installs all plugins and compiles themes automatically
- Customize plugins in lua/plugins/ and mappings in lua/mappings.lua
- Override or add themes via the base46 integration in chadrc.lua
- Requires Neovim 0.10+ and a Nerd Font for icon rendering

## Key Features
- base46 compiled theme engine for zero-cost colorscheme switching
- Custom statusline and tabufline replacing common plugin dependencies
- Startup time consistently under 50ms with full IDE features
- Structured starter template keeps framework updates non-destructive
- Built-in cheatsheet accessible with leader + ch

## Comparison with Similar Tools
- **kickstart.nvim** — educational single-file config; NvChad is a managed framework with UI plugins
- **LazyVim** — focuses on sensible defaults with extras system; NvChad emphasizes its own UI layer
- **AstroNvim** — community-driven plugin packs; NvChad uses compiled themes for speed
- **LunarVim** — standalone IDE layer with its own CLI; NvChad is a lighter framework approach
- **Doom Emacs** — Emacs-based; NvChad targets Neovim exclusively with Lua-first design

## FAQ
**Q: How do I update NvChad without losing my config?**
A: Run :NvChadUpdate from inside Neovim. Your customizations live in the starter template and remain untouched.

**Q: Can I use my own colorscheme instead of base46?**
A: Yes. You can load any Neovim colorscheme alongside or instead of the base46 theme system.

**Q: Is NvChad suitable for beginners?**
A: It provides a polished out-of-the-box experience, though understanding Lua basics helps when customizing.

**Q: How do I add a new LSP server?**
A: Add the server name to your Mason configuration in lua/plugins/init.lua and configure it via lspconfig.

## Sources
- https://github.com/NvChad/NvChad
- https://nvchad.com/docs/quickstart/install

---
Source: https://tokrepo.com/en/workflows/asset-93914c9b
Author: AI Open Source