https://github.com/piersolenski/plugin-addict.nvim
For those who just can't help themselves
https://github.com/piersolenski/plugin-addict.nvim
lua neovim neovim-plugin nvim nvim-lua nvim-plugin plugin-manager
Last synced: 5 months ago
JSON representation
For those who just can't help themselves
- Host: GitHub
- URL: https://github.com/piersolenski/plugin-addict.nvim
- Owner: piersolenski
- Created: 2025-08-15T12:31:09.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2025-08-18T12:14:25.000Z (6 months ago)
- Last Synced: 2025-09-06T21:24:59.914Z (5 months ago)
- Topics: lua, neovim, neovim-plugin, nvim, nvim-lua, nvim-plugin, plugin-manager
- Language: Lua
- Homepage:
- Size: 23.4 KB
- Stars: 4
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-neovim-sorted - piersolenski/plugin-addict.nvim
- awesome-neovim - piersolenski/plugin-addict.nvim - A stupidly simple way to quickly install plugins. (Plugin Manager)
README
# 🔌 plugin-addict.nvim
Ever find yourself constantly adding new plugins to your config? Yeah, me too. That's why I made `plugin-addict.nvim` - a dead simple plugin that does one thing: makes adding new plugins to your config **blazingly fast™**, so you can spend even less time working and more time tweaking your config.
## ✨ Features
- Creates a new plugin config file with one command
- Automatically names and places it in your plugins directory
- Opens it for editing immediately
- That's it. That's the plugin.
https://github.com/user-attachments/assets/b9b1e051-c8eb-4f07-b54f-a5fc3be31ae4
## 🔩 Installation
### Lazy
```lua
{
"piersolenski/plugin-addict.nvim",
opts = {},
keys = {
{
"n",
function()
require("plugin-addict").new()
end,
desc = "New plugin config",
},
},
}
```
### Packer
```lua
use({
"piersolenski/plugin-addict.nvim",
config = function()
require("plugin-addict").setup()
end,
})
```
## ⚙️ Configuration
`plugin-addict.nvim` works out of the box with no configuration necessary. If you want to customize the path for your plugins directory, you can use the `setup` function.
Here is the default configuration:
```lua
require("plugin-addict").setup({
-- The path to your plugins directory
plugins_path = vim.fn.stdpath("config") .. "/lua/plugins",
})
```
## 🚀 Usage
`plugin-addict.nvim` provides a command and Lua function to create new plugin files:
### Lua API
```lua
-- Prompt for plugin name
require("plugin-addict").new()
-- Create plugin with specific name
require("plugin-addict").new("cool-plugin")
```
### Commands
Prompt for plugin name:
`:PluginAddictNew [name]`
Create file directly:
`:PluginAddictNew [name]`
## ❓ FAQ:
**Q: Did this really need to be a plugin?**
A: No. But here we are.
**Q: Why would I use this?**
A: Because you're going to keep adding plugins anyway, might as well make it faster.
**Q: Is this just enabling my addiction?**
A: Yes. You're welcome.
## 🤓 About the author
As well as a passionate Vim enthusiast, I am a Full Stack Developer and Technical Lead from London, UK.
Whether it's to discuss a project, talk shop or just say hi, I'd love to hear from you!
- [Website](https://www.piersolenski.com/)
- [CodePen](https://codepen.io/piers)
- [LinkedIn](https://www.linkedin.com/in/piersolenski/)
