Modular neovim plugin configuration

In the previous post I hinted about configuring neovim plugins declaratively in Nix. Today, I discovered that this is indeed possible, 1 in some basic form, in home-manager.

The feature was added in PR #2637.

The old way

The old way is to add your plugin in Nix,

  plugins = with pkgs.vimPlugins; [

And then separately configure it in init.vim or init.lua — ie., extraConfig, as we did in Adding a neovim plugin: telescope.nvim.

The new way

However, instead, you could do both the above in the same place as:

  plugins = with pkgs.vimPlugins; [
      plugin = telescope-nvim;
      type = "lua";
      config = ''
        nmap("<leader>ff", ":Telescope find_files<cr>")
        nmap("<leader>fg", ":Telescope live_grep<cr>")
        nmap("<leader>fb", ":Telescope buffers<cr>")
        nmap("<leader>fh", ":Telescope help_tags<cr>")

It is not really declarative, though — more like modular. Declarative would be how Coc is configured in home-manager; see Haskell Language Server and Coc. Nevertheless, it is nice to be able to both configure and enable a plugin in the same place. Give the large number of neovim plugins in nixpkgs, it is not realistic to expect all of them to support declarative config anyway.