Ain't nobody got time to create plugin directories: boilit
yourself! boilit
creates boilerplate directory structure and code files for neovim plugins; although there is no unique way to do so, we create a reasonable tree structure useful for most use cases, so that you can build on it.
Go get it!
go install github.com/gennaro-tedesco/boilit@latest
All you have to do is thinking of an awesome name for your plugin: once you have it
boilit nvim-awesome-plugin
creates a plugin boilerplate structure as
.
├── autoload
│ └── health
│ └── nvim-awesome-plugin.vim
├── doc
│ ├── nvim-awesome-plugin.txt
│ └── tags
├── lua
│ └── nvim-awesome-plugin
│ ├── config.lua
│ ├── init.lua
│ └── main.lua
├── plugin
│ ├── nvim-awesome-plugin.vim
│ └── reload.vim
└── README.md
Watch it in action:
The plugin skeleton is created by default in the user's current directory: you can specify a custom location via the -p
flag
boilit nvim-awesome-plugin -p ~/custom/path
Check the help boilit -h
for further details.
Batteries included:
- headers and description of what goes in what file
- relative imports of lua modules
- a useful
reload.vim
function to reload your changes without having to exit and reload neovim - healthcheck template to appear in
:checkhealth
If your plugin name contains special characters or escape sequences, they may generate exceptions in some of the template functions: make sure to escape the escapable in case.
If you find this application useful consider awarding it a ⭐, it is a great way to give feedback! Otherwise, any additional suggestions or merge request is warmly welcome!