nvim-tree.lua is a file explorer tree for Neovim written in Lua.
The tool addresses the need for a native file browser within Neovim by providing a tree-structured view of the filesystem. It integrates directly with Neovim's ecosystem, offering features like automatic updates, file type icons through optional integration with nvim-web-devicons, Git status indicators, and LSP and COC diagnostics display. The explorer supports live filtering and standard file operations including rename, delete, create, cut, copy, and paste both locally and between separate instances. The interface is highly customizable through configuration options, custom key mappings, and highlight groups that can be modified at runtime.
Developers should choose this tool if they want a lightweight, Lua-based file explorer tightly integrated with Neovim rather than relying on external tools or Neovim's built-in netrw. It suits projects where users prefer a persistent sidebar navigator with Git awareness and diagnostic feedback. The tool requires Neovim 0.10 or later, with optional support for earlier versions through compatibility tags. File icons require nvim-web-devicons and a patched Nerd Font, though this is optional for basic functionality.
The project maintains a stable codebase focused on existing user experience rather than major feature additions. Development prioritizes the public API, encouraging users to implement custom features through documented extension points. The tool provides comprehensive documentation through help files, a wiki with showcases and recipes, and a discussions forum for community support.
