# LunarVim — IDE Layer for Neovim

> A community-driven Neovim IDE layer that provides a complete development environment with its own installer, configuration structure, and pre-configured plugin suite.

## Install

Save in your project root:

# LunarVim — IDE Layer for Neovim

## Quick Use
```bash
LV_BRANCH='release-1.4/neovim-0.9' bash <(curl -s https://raw.githubusercontent.com/LunarVim/LunarVim/release-1.4/neovim-0.9/utils/installer/install.sh)
lvim
```

## Introduction
LunarVim is an IDE layer built on top of Neovim that ships its own CLI installer and binary (lvim). It provides a pre-configured development environment with LSP, autocompletion, debugging, and a file explorer, while keeping user customizations isolated in a separate config directory.

## What LunarVim Does
- Installs as a standalone layer alongside your existing Neovim config
- Pre-configures LSP, null-ls, nvim-cmp, Treesitter, and nvim-tree
- Provides an lvim binary so it runs independently of your base Neovim setup
- Manages plugin installation and updates through its own runtime
- Supports user overrides in ~/.config/lvim/config.lua

## Architecture Overview
LunarVim installs itself into ~/.local/share/lunarvim and creates an lvim wrapper script that launches Neovim with LunarVim's runtime path prepended. The core configuration defines default plugins, LSP servers via Mason, and keybindings. User customizations in config.lua merge with or override the defaults at load time. This isolation means LunarVim does not interfere with a separate vanilla Neovim installation.

## Self-Hosting & Configuration
- Run the installer script which sets up the lvim binary and runtime
- Edit ~/.config/lvim/config.lua to customize plugins and settings
- Add plugins by appending to the lvim.plugins table in config.lua
- Configure language servers by modifying lvim.lsp settings
- Requires Neovim 0.9+, Node.js, Git, and a C compiler

## Key Features
- Standalone installation does not conflict with existing Neovim configs
- One-line installer with automatic dependency checking
- Built-in debugging support via nvim-dap with adapter configurations
- Consistent keybindings organized under the which-key leader menu
- Active plugin and LSP management through Mason integration

## Comparison with Similar Tools
- **LazyVim** — library-style distribution; LunarVim installs as a separate binary
- **NvChad** — focuses on custom UI theming; LunarVim focuses on IDE-complete defaults
- **AstroNvim** — community-driven extras; LunarVim takes a more opinionated single-config approach
- **kickstart.nvim** — educational starting point; LunarVim is a ready-to-use IDE layer
- **Spacemacs** — Emacs-based with layer system; LunarVim targets Neovim with Lua configuration

## FAQ
**Q: Can I run LunarVim alongside regular Neovim?**
A: Yes. LunarVim installs to its own directory and uses the lvim binary, leaving your nvim config untouched.

**Q: How do I add a new plugin?**
A: Add a lazy.nvim spec table to lvim.plugins in ~/.config/lvim/config.lua.

**Q: How do I update LunarVim?**
A: Run :LvimUpdate inside lvim or use the lvim +LvimUpdate +q command from the terminal.

**Q: Does LunarVim support debugging?**
A: Yes. It includes nvim-dap with pre-configured adapters for several languages.

## Sources
- https://github.com/LunarVim/LunarVim
- https://www.lunarvim.org/docs/installation

---
Source: https://tokrepo.com/en/workflows/asset-0eee73fc
Author: AI Open Source