netrw.nvim

It's not because we use netrw that we cannot have nice things! This plugin adds a layer of ✨bling✨ and configuration to your favorite file explorer.

Features

• Print file icons in the sign column
• Configure custom actions with keybinds

Requirements

• Neovim >= 0.5.0
• One of the following icon provider plugin (optional):
  • mini.icons
  • nvim-web-devicons
• A patched font (optional)

Installing

Install the plugin with your preferred package manager:

lazy.nvim

{ 'prichrd/netrw.nvim', opts = {} }

vim-plug

Plug 'prichrd/netrw.nvim'

packer

use 'prichrd/netrw.nvim'

Configuration

Enable the plugin with the default configuration:

require("netrw").setup({})

Or customize the options to fit your needs:

require("netrw").setup({
  -- File icons to use when `use_devicons` is false or if
  -- no icon is found for the given file type.
  icons = {
    symlink = '',
    directory = '',
    file = '',
  },
  -- Uses mini.icon or nvim-web-devicons if true, otherwise use the file icon specified above
  use_devicons = true,
  mappings = {
    -- Function mappings receive an object describing the node under the cursor
    ['p'] = function(payload) print(vim.inspect(payload)) end,
    -- String mappings are executed as vim commands
    ['<Leader>p'] = ":echo 'hello world'<CR>",
  },
})

Contributing

This project accepts contributions. Feel free to open issues for questions, feature ideas, bugs, etc. Before submitting a PR, make sure you run make lint with stylua and luacheck installed.