> [!WARNING] > Main branch is only updated for small, non-breaking changes. For the latest version of neovim-flake, please see > [the list of branches](https://github.com/NotAShelf/neovim-flake/branches) or > [open pull requests](https://github.com/NotAShelf/neovim-flake/pulls?q=is%3Apr+is%3Aopen+sort%3Aupdated-desc). > neovim-flake, at the time, is still being actively developed - and will continue to be so for the foreseeable > future. --- [Get Started]: #get-started [Documentation]: #documentation [Help]: #help [Contribute]: #contributing [FAQ]: #faq [Credits]: #credits --- ## Get Started ### Using `nix` CLI If you would like to try out the configuration before even thinking about installing it, you can run the following command ```console nix run github:notashelf/nvf ``` This will get you a feel for the base configuration and UI design. The flake exposes `#nix` as the default package, providing minimal language support and various utilities.You may also use `#nix`, `#tidal` or `#maximal` to get try out different configurations. It is as simple as changing the target output to get a different configuration. For example, to get a configuration with `tidal` support, run: ```console nix run github:notashelf/nvf#tidal ``` Similar instructions will apply for `nix profile install`. However, you are recommended to instead use the module system as described in the manual. > [!NOTE] > The `maximal` configuration is _massive_ and will take a while to build. > To get a feel for the configuration, use the default `nix` or `tidal` > configurations. Should you choose to try out the `maximal` configuration, > using the binary cache as described in the manual is _strongly_ recommended. ## Documentation See the [**nvf** Manual](https://notashelf.github.io/nvf/) for detailed installation guides, configurations, available options, release notes and more. Tips for installing userspace plugins is also contained in the documentation. If you want to dive right into trying **nvf** you can get a fully featured configuration with `nix` language support by running: ```console nix run github:notashelf/nvf#nix ``` Please create an issue on the [issue tracker](../../../issues) if you find the documentation lacking or confusing. I also appreciate any contributions to the documentation. ## Help You can create an issue on the [issue tracker](../../../issues) to ask questions or report bugs. I am not yet on spaces like matrix or IRC, so please use the issue tracker for now. ## Contributing I am always looking for new ways to help improve this flake. If you would like to contribute, please read the [contributing guide](CONTRIBUTING.md) before submitting a pull request. You can also create an issue on the [issue tracker](../../../issues) before submitting a pull request if you would like to discuss a feature or bug fix. ## FAQ **Q**: Can you add _X_?
**A**: Maybe! It is not one of our goals to support each and every Neovim plugin, however, I am always open to new modules and plugin setup additions to **nvf**. Use the [appropritate issue template](https://github.com/NotAShelf/nvf/issues/new/choose) and I will consider a module addition. **Q**: A plugin I need is not available in **nvf**. What to do?
**A**: **nvf** exposes several APIs for you to be able to add your own plugin configurations! Please see the documentation on how you may do this. ## Credits ### Contributors Special thanks to - [@fufexan](https://github.com/fufexan) - For the transition to flake-parts - [@FlafyDev](https://github.com/FlafyDev) - For getting the home-manager to work - [@n3oney](https://github.com/n3oney) - For making custom keybinds finally possible - [@horriblename](https://github.com/horriblename) - For actively implementing planned features and quality of life updates - [@Yavko](https://github.com/Yavko) - For the amazing **nvf** logo - [@FrothyMarrow](https://github.com/FrothyMarrow) - For seeing mistakes that I could not and everyone who has submitted issues or pull requests! ### Inspiration This configuration borrows from and is based on a few other configurations, including: - [@jordanisaacs's](https://github.com/jordanisaacs) [neovim-flake](https://github.com/jordanisaacs/neovim-flake) that this flake is originally based on. - [@sioodmy's](https://github.com/sioodmy) [dotfiles](https://github.com/sioodmy/dotfiles) that inspired the design choices. - [@wiltaylor's](https://github.com/wiltaylor) [neovim-flake](https://github.com/wiltaylor/neovim-flake) for plugin and design ideas. - [@gvolpe's](https://github.com/gvolpe) [neovim-flake](https://github.com/gvolpe/neovim-flake) for plugin, design and nix concepts. I am grateful for their previous work and inspiration, and I wholeheartedly recommend checking their work out.
## License Following the [original neovim-flake](https://github.com/jordanisaacs/neovim-flake) **nvf** has been made available under the **MIT License**. However, all assets are published under the [CC BY License]. ---