domus-nvim: Key Bindings & Development

Key Bindings

Leader: <Space>

Navigation

Binding Action

<Space>ff

Find files (Telescope)

<Space>fg

Live grep

<Space>e

File browser (Oil)

<C-e>

Harpoon menu

<Space>fb

Buffers

LSP

Binding Action

gd

Go to definition

gD

Go to declaration

gP

Glance peek definitions

gr

References

K

Hover documentation

<Space>ca

Code action

<Space>rn

Rename symbol

<Space>ih

Toggle inlay hints

Git

Binding Action

<Space>gs

Git status

<Space>lg

LazyGit

<Space>gd

Diffview

<Space>gh

File history

<Space>hs

Stage hunk

<Space>hp

Preview hunk

]c / [c

Next/prev hunk

AsciiDoc (buffer-local, ft=asciidoc)

Binding Action

]] / [[

Next/prev section

]- / [-

Next/prev code block

]i / [i

Next/prev include

]x / [x

Next/prev xref

]d / [d

Next/prev diagram block

<Space>ao

Document outline

<Space>aw

Word count (excl. syntax)

<Space>aX

Find broken xrefs

<Space>aA

Check undefined attributes

<Space>ap

Preview attributes

<Space>aD

List diagram blocks

<Space>ax

Toggle checklist item

<Space>ab

Bold word/selection

<Space>ai

Italic word/selection

<Space>ac

Monospace word/selection

Development

# Launch with dedicated config
NVIM_APPNAME=nvim-domus nvim

# Or use alias (defined in .zshrc)
v

# Build documentation
cd ~/atelier/_projects/personal/domus-nvim
make docs           # Build Antora site
make docs-open      # Build and open in browser
make docs-serve     # Serve on localhost:8000

Custom Features

Feature Description

MOTD

Message of the day popup on startup

AsciiDoc Suite

Outline, word count, broken xref finder, attribute checker/preview, diagram listing

Colorscheme

Catppuccin Mocha with custom refinements:

  • Muted yellow visual selection highlight (#454025)

  • Custom overrides in plugins/config/colorscheme.lua

Goals

  • Hierarchical plugin architecture (specs vs configs)

  • Native ftplugin for filetype settings

  • Embedded Antora documentation

  • Catppuccin Mocha theme with customizations

  • Termux compatibility (native LSP fallback)

  • WSL compatibility

  • blink.cmp completion engine (replaced nvim-cmp)

  • selene Lua linter (replaced luacheck — Mason/Lua 5.5 incompatibility)

  • AsciiDoc module upgrade (25 diagram snippets, 5 commands, navigation)

  • Consolidated Termux detection into core/util.lua

  • Dead code audit (removed unused util functions, empty ui module)

  • Expanded which-key registrations (60+ key descriptions)

  • Fixed LuaSnip parse errors in AsciiDoc snippet definitions (LuaJIT ="] / stray } edge cases)

  • Complete DAP configurations

  • Document all keymaps in Antora docs