Declarative NixOS module to provision Neovim with a Lua-based config scaffold, Catppuccin mocha green theme and essential plugins.
-
🔒 Secure config scaffold : Creates
~/.config/nvimand subdirectories with700/600permissions. -
🎨 Catppuccin mocha green : Deploys
catppuccin.luatheme inlua/plugins. -
⚙️ Plugin templates : Includes starter configs for
blink,conform,gitsigns,lazydev,LSP,treesitter,telescope,todo-comments,which-keyand more. -
🚀 Language support : Installs
go,rustup,python3,rubyfor LSP and tooling. -
📋 Clipboard integration : Adds
xclipandcopyqfor system clipboard support. -
🔄 Idempotent : Safe to run on every
nixos-rebuild, preserves and updates config files. -
🔮 Evolving : Configuration is under active development—expect frequent improvements.
-
💾 Manual backups : Backup commands are provided in the documentation to preserve existing files before changes if needed.
Requires NixOS 24.11 or newer.
the target user must be defined in config.username. See typovrak main nixos configuration for more details.
Before proceeding, back up existing configuration if needed
cp ~/.config/nvim{,.bak}Fetch the module directly in your main nixos configuration at /etc/nixos/configuration.nix using fetchGit
# /etc/nixos/configuration.nix
let
nixos-nvim = fetchGit {
url = "https://github.com/typovrak/nixos-nvim.git";
ref = "main";
rev = "eea0e1d5fb671859b6729c2c788fad3d68de4eea"; # update to the desired commit
};
in
{
imports = [
/etc/nixos/hardware-configuration.nix # system hardware settings
/etc/nixos/variables.nix # defines config.username and other variables, see https://github.com/typovrak/nixos for more details
(import "${nixos-nvim}/configuration.nix")
];
}Once imported, rebuild your system to apply changes
sudo nixos-rebuild switchStart coding now with nvim !
If this module saved you time, please ⭐️ the repo and share feedback.
You can also support me on ☕ Buy me a coffee.
Distributed under the MIT license.
This project maintains a code of conduct to ensure a respectful, inclusive and constructive community.
To report vulnerabilities or learn about supported versions and response timelines, please see our security policy.
Made with 💜 by typovrak