Neve (snow in portuguese) is a meticulously crafted custom configuration for Nixvim, designed to revolutionize your development workflow and provide an unparalleled coding experience. This configuration is the culmination of expertise and passion, aiming to provide sane defaults.
-
Powerful Development Environment: Neve is tailored to deliver a robust and efficient development environment. With carefully selected plugins, optimized settings, and thoughtful customization, it ensures that your coding journey is both smooth and productive.
-
Nixvim Integration: Built on the foundation of Nixvim, Neve seamlessly integrates with the powerful Nix package manager. This integration not only simplifies the setup process but also guarantees a consistent and reproducible development environment across different machines.
-
Thoughtful Customization: Neve doesn't just stop at default settings. It's designed to be easily customizable, allowing you to tailor your Nixvim experience to match your unique preferences and workflow.
-
Extensive Plugin Support: Benefit from a curated selection of plugins that cover a wide range of programming languages and development tasks. Neve comes with pre-configured plugins to boost your productivity, and you can effortlessly expand its capabilities to suit your specific needs.
Getting started with Neve is a breeze. Simply follow the installation guide below, and you'll be up and running in no time.
However if you'd like to give it a try before installing, nix run github:redyf/neve is available!
INSTALLATION GUIDE
I'm assuming you already use nix flakes but in case you don't, please check this tutorial to enable them:-
Go to flake.nix and add Neve.url = "github:redyf/Neve" to your inputs.
-
Run nix flake update, then Neve should be available for installation.
Option 1: Using Flakes to install Neve as a Nixvim module.
- Install it by adding the following code to Nixvim configuration:
programs.nixvim = {
enable = true;
imports = [ inputs.Neve.nixvimModule ];
# Then configure Nixvim as usual, you might have to lib.mkForce some of the settings
colorschemes.catppuccin.enable = lib.mkForce false;
colorschemes.nord.enable = true;
};- Rebuild your system and you should be done :
Option 2: Using Flakes to install Neve as a package
After enabling it, follow the steps below:
-
Install it by adding
inputs.Neve.packages.${pkgs.system}.defaultto your environment.systemPackages or home.packages if you're using home-manager. -
Rebuild your system and you should be done :
How to enable/disable modules
For those who aren't familiar with the modular structure of nix, make sure to check this great tutorial made by Vimjoyer.Modularize NixOS and Home Manager | Great Practices
Basically all you need to do is go to the default.nix file of each directory and enable/disable the mkDefault options.
Lets say you want to enable neo-tree, in order to do that you'd have to go to config/filetrees/default.nix and change its value from
config = lib.mkIf config.filetrees.enable {
neo-tree.enable = lib.mkDefault false;
};to
config = lib.mkIf config.filetrees.enable {
neo-tree.enable = lib.mkDefault true;
};However, sometimes you'll have many plugins in the same directory and it can be quite annoying to change the value for all of them individually. So instead you can disable them all at once in config/default.nix like below:
To disable all UI plugins for example, you can easily do it by going to config/default.nix and toggling the value from true to false:
ui.enable = lib.mkDefault false;If you would like to customize Neve to your liking, check this out!
1- Fork the repo (you can also change the name of the fork if you want).
2- Clone the fork.
3- Make the changes you want, such as enabling/disabling plugins, changing colorschemes, neovim options, etc.
4- Add the fork to your flake.nix file, the original is Neve.url = “github:redyf/Neve”. If a user called foo forks the repo and renames it to bar, it would be bar.url = “github:foo/bar”.
5- Update your inputs and install the fork with inputs.Neve.packages.${pkgs.system}.default.
6- Rebuild the system and you should be done!
Neve is highly customizable. Here are some important files for configuring your environment:
-
config/default.nix: This file contains the main configuration file. You can add or delete plugins as you like.
-
config/sets/set.nix: In this file, you can add or remove options and adjust their specific settings.
-
config/keys.nix: This file contains custom key mappings. You can add your own keyboard shortcuts to enhance productivity.
-
config/lsp/lsp-nvim.nix: Here you can configure your preferred Language Servers.
-
config/lsp/conform.nix: Configure Formatters for the desired languages.
-
config/languages/nvim-lint.nix: Set up linters for specific languages.
Contributions are welcome! Feel free to open an issue to report problems, suggest improvements, or submit pull requests to add new features to Neve.
This project is licensed under the MIT License. See the LICENSE file for more details.
Encountered an issue or have a question? Visit our Issue Tracker or message me on Discord, my username is redyf.
Happy coding!