Question 1

How to install guihua.lua in Neovim with Packer?

Accepted Answer

Use `use {'ray-x/guihua.lua', run = 'cd lua/fzy && make'}` in your Packer configuration, which builds the fzy dependency automatically during installation. Ensure Neovim is updated to support multigrid features for full functionality.

Question 2

Guihua.lua vs telescope.nvim for list selectors?

Accepted Answer

Guihua.lua is more lightweight and focused on providing raw GUI components for custom plugin interfaces, while telescope.nvim is a comprehensive fuzzy finder with pre-built UI and extensive integrations. Choose Guihua if you need to build bespoke UIs; opt for Telescope for ready-to-use, feature-rich selection interfaces.

Question 3

How to create a floating window with guihua.lua?

Accepted Answer

Refer to the test files in the repository for examples, as the README points to them for API usage. Typically, you'll use the provided floating window utilities and configure them via Lua, similar to how ListView and Preview components are implemented in the tests.

Question 4

Does guihua.lua support custom themes or styling?

Accepted Answer

Yes, it allows customization through overriding default icons and mappings, as shown in the setup example where icons and keymaps can be extended. However, styling is limited to Neovim's window and buffer attributes, not CSS-like themes.

Question 5

What are the performance implications of using guihua.lua's fuzzy finder?

Accepted Answer

It uses a modified version of fzy-lua-native, which is optimized for speed in Lua, but performance can vary with large datasets. The FFI build option may offer better performance, but requires the extra `make` step during setup.

Question 6

How to handle keyboard mappings in guihua.lua components?

Accepted Answer

Configure mappings via the `setup` function, as shown in the README with examples like `close_view = '<C-x>'`. These can be customized to avoid conflicts with other Neovim plugins or user keybindings.

guihua.lua

What is guihua.lua?

Overview

Use Cases

Best For

Related Projects

Found a gem we're missing?

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions