Question 1

How do I configure nap.nvim to avoid keybinding conflicts?

Accepted Answer

Use the setup function to customize prefix and repeat keys, and exclude default operators if needed. The README suggests trying keys like <Space> or ; based on your workflow, but be mindful of existing mappings in your Neovim config.

Question 2

nap.nvim vs unimpaired.vim: which should I use?

Accepted Answer

Choose nap.nvim if you want a lightweight, navigation-only plugin with single-key repeat cycling. Opt for unimpaired.vim if you need additional editing commands like line bubbling or option toggling alongside navigation.

Question 3

Can I use nap.nvim to navigate Git hunks or changes?

Accepted Answer

Yes, but it requires integration with Gitsigns.nvim using the provided helper function. You'll need to map an operator, such as 'c', to handle next/previous Git changes, as shown in the README example.

Question 4

How to add a custom operator for navigating LSP symbols or outlines?

Accepted Answer

Use the map function with a Lua table defining next and prev actions. For instance, with Aerial.nvim, you can map 'o' to aerial() helper, or define your own commands for other symbol browsers.

Question 5

What are the best repeat keys for nap.nvim in a terminal?

Accepted Answer

The README recommends avoiding keys like if unsupported by your terminal. Instead, try / or remap keys like ; and , if freed by other plugins, ensuring they don't conflict with Neovim defaults.

Question 6

Does nap.nvim work with fuzzy finders like telescope?

Accepted Answer

Not directly—it's designed for linear navigation through lists. For fuzzy searching, use Telescope separately; nap.nvim complements it by providing quick cycling through results in quickfix or location lists.

Question 7

How to disable default operators I don't use?

Accepted Answer

In the setup call, use the exclude_default_operators option to list keys like 'a' for tabs. This prevents mapping conflicts and keeps your keymap clean, as detailed in the configuration section.

nap.nvim

What is nap.nvim?

Overview

Use Cases

Best For

Related Projects

Found a gem we're missing?

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions