lvim

# LVIM

![LVIM](/assets/lvim-logo.png)

> A modular Neovim configuration written in Lua, built entirely on a first-party plugin ecosystem —
> `lvim-tech/*`. LSP and language tooling, debugging, building and testing, git, database and REST
> clients, the whole UI: one set, one style, one place to configure it.

> Current version — **10.3.0**

---

## At a glance

Measured on this machine, on the revisions the active snapshot pins — the editor answers the same
questions live, and the commands that ask are in the last column.

| What | Measured | Ask the editor |
|---|---|---|
| **Plugins** | **65**, all but one first-party | `:LvimInstaller` |
| **Startup** | **~110 ms** to a usable editor (98–115 ms over five runs) | the dashboard, or `require("lvim-pack").stats()` |
| **Languages** | **92 providers** over **150 filetypes** | `:LvimLang providers` |
| **LSP** | **94 distinct language servers**, attached per project root | `:LvimLsp info` |
| **Run / Build** | **49** languages run, **47** build | `:LvimBuild`, `:LvimLang status` |
| **Test** | **44** languages, with treesitter discovery | `:LvimTest` |
| **Debug** | **17** languages with a real adapter — nothing stubbed to pad the number | `:LvimDap adapters` |
| **Commands** | **61** `:Lvim*` commands | `:LvimPicker commands` |

Nothing on that list is installed up front: a language server, parser, formatter, linter or debug
adapter is fetched the first time you open a file that needs it, and you are asked before it is.

---

## Documentation

The detail lives in its own file — this page is the overview.

| Page | What is in it |
|---|---|
| [docs/plugins.md](docs/plugins.md) | every plugin: what it is, when it loads, what it depends on |
| [docs/languages.md](docs/languages.md) | the language model, all 92 providers, per-project overrides |
| [docs/keys.md](docs/keys.md) | the whole keymap manifest, group by group |
| [docs/commands.md](docs/commands.md) | every command and its subcommands |

---

## Philosophy

**One ecosystem, not a collection.** Every plugin is written for this set: they share a palette, a
highlight factory, a storage layer, a UI toolkit and a cursor manager. A theme change repaints all of
them; a panel opened by one behaves like a panel opened by another. The single third-party entry left
is a runtime *library* (`sqlite.lua`), not a plugin.

**No external plugin manager.** `lvim-pack` drives Neovim's own `vim.pack` — dependencies, version
pins, eager order, lazy triggers, build hooks. One clone, no bootstrap script to trust.

**Nothing loads that is not needed.** Plugins that must be listening at the first keystroke load at
startup by priority; the rest wait on a filetype, a command, a key or an event. Where a plugin waits
on a command, its keymap calls that command — so it arrives exactly when you first ask for it.

**One place per question.** Keymaps live in one manifest, not scattered across plugin configs.
A language declares everything about itself in one provider. A set