Skip to content

Commit

Permalink
docs(readme): init
Browse files Browse the repository at this point in the history
  • Loading branch information
mrcjkb committed Jun 10, 2024
1 parent 3deb6bb commit 64a0bef
Show file tree
Hide file tree
Showing 2 changed files with 24 additions and 29 deletions.
4 changes: 2 additions & 2 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ CI checks are run using [`nix`](https://nixos.org/download.html#download-nix).

### Dev environment

I use the following tools:
We use the following tools:

#### Formatting

Expand Down Expand Up @@ -71,7 +71,7 @@ Or

> [!NOTE]
>
> The Nix devShell sets up `luarocks test` to use Neovim as the interpreter.
> The Nix devShell sets up `luarocks test` and `busted` to use Neovim as the interpreter.
### Running tests and checks with Nix

Expand Down
49 changes: 22 additions & 27 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,37 +1,32 @@
# An opinionated Neovim Lua plugin template with a Nix CI
# lz.n

A dead simple lazy-loading Lua library for Neovim plugins.

![Neovim](https://img.shields.io/badge/NeoVim-%2357A143.svg?&style=for-the-badge&logo=neovim&logoColor=white)
![Lua](https://img.shields.io/badge/lua-%232C2D72.svg?style=for-the-badge&logo=lua&logoColor=white)
![Nix](https://img.shields.io/badge/nix-0175C2?style=for-the-badge&logo=NixOS&logoColor=white)

This repository is a template for Neovim plugins written in Lua.

## Features

- GitHub Actions workflows with a locally reproducible CI,
using [`nix` flakes](https://nixos.wiki/wiki/Flakes).
- Run tests with both neovim stable and neovim nightly
using [`neorocksTest`](https://github.com/nvim-neorocks/neorocks).
- Lints and a nix shell with pre-commit-hooks:
- [`luacheck`](https://github.com/mpeterv/luacheck)
- [`stylua`](https://github.com/JohnnyMorganz/StyLua)
- [`lua-language-server` static type checks](https://github.com/LuaLS/lua-language-server/wiki/Diagnosis-Report)
- [`alejandra`](https://github.com/kamadorueda/alejandra)
- [`editorconfig-checker`](https://github.com/editorconfig-checker/editorconfig-checker)
- [`markdownlint`](https://github.com/DavidAnson/markdownlint)
- `vimPlugin` nix flake output.
- Automatically publish tags to [LuaRocks](https://luarocks.org/labels/neovim)
with the [luarocks-tag-release action](https://github.com/nvim-neorocks/luarocks-tag-release).
- Automatic release PRs using [conventional commits](https://conventionalcommits.org/)
with [release-please](https://github.com/googleapis/release-please).
- Automatically comment PRs with a review checklist.

## Contributing

## :star2: Features

- API for lazy-loading plugins on:
- Events (`:h autocmd-events`)
- `FileType` events
- Key mappings
- User commands
- Works with:
- Neovim's built-in `:h packpath` (`:h packadd`)
- Any plugin manager that supports manual lazy loading
- Configurable in multiple files

## :pencil: Requirements

- `Neovim >= 0.9.1`

## :green_heart: Contributing

All contributions are welcome!
See [CONTRIBUTING.md](./CONTRIBUTING.md).

## License
## :book: License

This template is [licensed](./LICENSE) according to GPL version 2
or (at your option) any later version.

0 comments on commit 64a0bef

Please sign in to comment.