Go to file
github-actions[bot] f9ff00bc06
chore(master): release nvim-tree 1.5.0 (#2810)
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
2024-07-11 16:17:05 +10:00
.github chore(deps): bump nvim-neorocks/luarocks-tag-release from 5 to 7 (#2808) 2024-07-07 12:55:47 +10:00
.hooks ci: lua language server and Makefile (#2546) 2024-01-06 13:18:52 +11:00
doc feat(#2598): add api.tree.resize (#2811) 2024-07-11 15:15:40 +10:00
lua fix(#2813): macos: enable file renaming with changed capitalization (#2814) 2024-07-11 16:15:03 +10:00
scripts ci: add lua-language-server 3.9.1 (#2782) 2024-05-25 15:42:38 +10:00
.editorconfig feat(#2092): add api.node.navigate.open.next, prev (#2093) 2023-04-03 14:23:03 +10:00
.gitignore ci: lua language server and Makefile (#2546) 2024-01-06 13:18:52 +11:00
.luacheckrc refacto: set tree explorer in the global state 2022-02-07 22:07:08 +01:00
.luarc.json chore(#2787): minimum nvim version 0.9, replace 0.10 deprecated, enable deprecated warnings (#2788) 2024-06-09 12:24:35 +10:00
.release-please-manifest.json chore(master): release nvim-tree 1.5.0 (#2810) 2024-07-11 16:17:05 +10:00
.stylua.toml chore: stylua column width 120 -> 140 (#2448) 2023-10-08 11:40:58 +11:00
CHANGELOG.md chore(master): release nvim-tree 1.5.0 (#2810) 2024-07-11 16:17:05 +10:00
CONTRIBUTING.md chore(#2731): neovim luadoc 0.10 compliance (#2786) 2024-06-01 15:24:03 +10:00
LICENSE renaming: lua-tree -> nvim-tree 2020-12-27 19:14:34 +01:00
Makefile chore(#2787): minimum nvim version 0.9, replace 0.10 deprecated, enable deprecated warnings (#2788) 2024-06-09 12:24:35 +10:00
README.md chore(#2787): minimum nvim version 0.9, replace 0.10 deprecated, enable deprecated warnings (#2788) 2024-06-09 12:24:35 +10:00
release-please-config.json chore: first release (#2588) 2023-12-11 01:36:12 +01:00

A File Explorer For Neovim Written In Lua


Automatic updates

File type icons

Git integration

Diagnostics integration: LSP and COC

(Live) filtering

Cut, copy, paste, rename, delete, create

Highly customisable

Take a look at the wiki for Showcases, Tips, Recipes and more.

Questions and general support: Discussions


neovim >=0.9.0

nvim-web-devicons is optional and used to display file icons. It requires a patched font. Your terminal emulator must be configured to use that font, usually "Hack Nerd Font"


Please install via your preferred package manager. See Installation for specific package manager instructions.


Major or minor versions may be specified via tags: v<MAJOR> e.g. v1 or v<MAJOR>.<MINOR> e.g. v1.23

nvim-tree/nvim-web-devicons optional, for file icons

Disabling netrw is strongly advised, see :help nvim-tree-netrw

Quick Start


Setup the plugin in your init.lua

-- disable netrw at the very start of your init.lua
vim.g.loaded_netrw = 1
vim.g.loaded_netrwPlugin = 1

-- optionally enable 24-bit colour
vim.opt.termguicolors = true

-- empty setup using defaults

-- OR setup with some options
  sort = {
    sorter = "case_sensitive",
  view = {
    width = 30,
  renderer = {
    group_empty = true,
  filters = {
    dotfiles = true,


Open the tree: :NvimTreeOpen

Show the mappings: g?

Custom Mappings

:help nvim-tree-mappings-default are applied by default however you may customise via |nvim-tree.on_attach| e.g.

local function my_on_attach(bufnr)
  local api = require "nvim-tree.api"

  local function opts(desc)
    return { desc = "nvim-tree: " .. desc, buffer = bufnr, noremap = true, silent = true, nowait = true }

  -- default mappings

  -- custom mappings
  vim.keymap.set('n', '<C-t>', api.tree.change_root_to_parent,        opts('Up'))
  vim.keymap.set('n', '?',     api.tree.toggle_help,                  opts('Help'))

-- pass to setup along with your other options
require("nvim-tree").setup {
  on_attach = my_on_attach,


Run :NvimTreeHiTest to show all the highlights that nvim-tree uses.

They can be customised before or after setup is called and will be immediately applied at runtime. e.g.

    :hi      NvimTreeExecFile    guifg=#ffa0a0
    :hi      NvimTreeSpecialFile guifg=#ff80ff gui=underline
    :hi      NvimTreeSymlink     guifg=Yellow  gui=italic
    :hi link NvimTreeImageFile   Title

See :help nvim-tree-highlight for details.


See :help nvim-tree-commands

Basic commands:

:NvimTreeToggle Open or close the tree. Takes an optional path argument.

:NvimTreeFocus Open the tree if it is closed, and then focus on the tree.

:NvimTreeFindFile Move the cursor in the tree for the current buffer, opening folders if needed.

:NvimTreeCollapse Collapses the nvim-tree recursively.


nvim-tree is stable and new major features will not be added. The focus is on existing user experience.

Users are encouraged to add their own custom features via the public API.

Development is focused on:

  • Bug fixes
  • Performance
  • Quality of Life improvements
  • API / Events
  • Enhancements to existing features


nvim-tree exposes a public API. This is non breaking, with additions made as necessary. See :help nvim-tree-api

See wiki Recipes and Tips for ideas and inspiration.

Please raise a feature request if the API is insufficient for your needs. Contributions are always welcome.

You may also subscribe to events that nvim-tree will dispatch in a variety of situations, see :help nvim-tree-events


PRs are always welcome. See wiki to get started.

See bug and PR Please issues if you are looking for some work to get you started.


See Showcases wiki page for examples of user's configurations with sources.

Please add your own!