Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/2kabhishek/template.nvim
Ready to go Neovim template 🏗️✈️
https://github.com/2kabhishek/template.nvim
community neovim neovim-plugin plugin template terminal vim
Last synced: 17 days ago
JSON representation
Ready to go Neovim template 🏗️✈️
- Host: GitHub
- URL: https://github.com/2kabhishek/template.nvim
- Owner: 2KAbhishek
- License: gpl-3.0
- Created: 2024-09-15T00:49:34.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2024-10-16T09:38:32.000Z (about 1 month ago)
- Last Synced: 2024-11-02T02:05:20.114Z (17 days ago)
- Topics: community, neovim, neovim-plugin, plugin, template, terminal, vim
- Language: Lua
- Homepage:
- Size: 38.1 KB
- Stars: 6
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
template.nvim is a neovim plugin that allows neovim users to ``.
## ✨ Features
- Includes a ready to go neovim plugin template
- Comes with a lint and test CI action
- Includes a Github action to auto generate vimdocs
- Comes with a ready to go README template
- Works with [mkrepo](https://github.com/2kabhishek/mkrepo)
## ⚡ Setup
### ⚙️ Requirements
- Latest version of `neovim`
### 💻 Installation
```lua
-- Lazy
{
'2kabhishek/template.nvim',
dependencies = {
'nvim-lua/plenary.nvim'
},
cmd = 'TemplateHello',
},
-- Packer
use '2kabhishek/template.nvim'
```
## 🚀 Usage
1. Fork the `template.nvim` repo
2. Update the plugin name, file names etc, change `template` to `your-plugin-name`
3. Add the code required for your plugin,
- Main logic, config options for the plugin code goes into [lua/template](./lua/template.lua)
- Supporting code goes into [lua/modules](./lua/template/) if needed
- For adding commands and keybindngs use [plugin/template](./plugin/template.lua)
4. Add test code to the [tests](./tests/template_spec.lua) file
5. Update the README
6. Tweak the [docs action](./.github/workflows/docs.yml) file to reflect your username, commit message and plugin name
- Generating vimdocs needs write access to actions (repo settings > actions > general > workflow permissions)
### Configuration
template.nvim can be configured using the following options:
```lua
template.setup({
name = 'template.nvim', -- Name to be greeted, 'World' by default
})
```
### Commands
`template.nvim` adds the following commands:
- `TemplateHello`: Shows a hello message with the confugred name.
### Keybindings
It is recommended to use:
- `th,` for `TemplateHello`
> NOTE: By default there are no configured keybindings.
### Help
Run `:help nerdy` for more details.
## 🏗️ What's Next
Planning to add ``.
### ✅ To-Do
- [x] Setup repo
- [ ] Think real hard
- [ ] Start typing
## ⛅ Behind The Code
### 🌈 Inspiration
template.nvim was inspired by [nvim-plugin-template](https://github.com/ellisonleao/nvim-plugin-template), I added some changes on top to make setting up a new plugin faster.
### 💡 Challenges/Learnings
- The main challenges were ``
- I learned about ``
### 🧰 Tooling
- [dots2k](https://github.com/2kabhishek/dots2k) — Dev Environment
- [nvim2k](https://github.com/2kabhishek/nvim2k) — Personalized Editor
- [sway2k](https://github.com/2kabhishek/sway2k) — Desktop Environment
- [qute2k](https://github.com/2kabhishek/qute2k) — Personalized Browser
### 🔍 More Info
- [nerdy.nvim](https://github.com/2kabhishek/nerdy.nevim) — Find nerd glyphs easily
- [tdo.nvim](https://github.com/2KAbhishek/tdo.nvim) — Fast and simple notes in Neovim
- [termim.nvim](https://github.com/2kabhishek/termim,nvim) — Neovim terminal improved
⭐ hit the star button if you found this useful ⭐
Source
| Blog
| Twitter
| LinkedIn
| More Links
| Other Projects
