PRJ: domus-nvim

Project Summary

Project

domus-nvim

Priority

P1

Status

Active Development

Location

~/atelier/_projects/personal/domus-nvim/

Started

December 2025

Symlink

~/.config/nvim-domus

Alias

v (NVIM_APPNAME=nvim-domus nvim)

Purpose

Primary Neovim configuration following hierarchical, modular architecture. Separates plugin specifications from configurations for maintainability. Includes embedded Antora documentation.

Requirements

Component Version Notes

Neovim

0.11.0+

Required for vim.lsp.config API

Git

2.19+

Plugin installation via lazy.nvim

Node.js

18+

Optional - for LSP servers

ripgrep

Any

Optional - for Telescope live grep

Improvement Proposals

Proposals from ecosystem audit — 2026-04-04. For team review and prioritization.

Priority Proposal Rationale Effort

P1

Add LSP configuration reference table

Which LSPs are configured, per language, with their settings. Currently buried in Lua files — should be a scannable table.

M

P2

Keybinding cheatsheet partial

Custom keybindings are the muscle memory layer. A printable cheatsheet partial (leader key combos, telescope maps, etc.) is high utility.

S

P2

Plugin dependency graph

lazy.nvim manages 30+ plugins with load-order dependencies. A graph showing which plugins trigger which (via events, ft, keys) prevents breakage.

M

P3

Performance tuning guide (lazy loading, startup time)

Document the lazy-loading strategy, startup profiling commands (--startuptime), and optimization decisions.

S

P2

Consolidate Termux detection into core/util.lua ✓ Done

Completed 2026-04-04. util.is_termux() now shared by mason-tools.lua and lsp/init.lua.

S

P3

Add debouncing to nvim-lint InsertLeave autocommand

Linting fires on every InsertLeave event with no throttle. Could cause lag in rapid editing scenarios. Add debounce or limit to BufWritePost only.

S

P3

Extract AsciiDoc lang config into smaller modules ✓ Superseded

Kept as single 1100-line module (well-sectioned). Splitting adds indirection without benefit. Module upgraded with 25 diagram snippets, 5 commands, improved navigation.

M

Notes

Primary editor configuration. Uses NVIM_APPNAME for isolation from other Neovim configs (nvim-core, nvim-modulus, nvim-fidus, domus-minimus). Focus on clean separation of concerns and lazy loading for performance.