default

nix flake init -t github:BirdeeHub/nixCats-nvim

Starting point template for making your Neovim flake. This is the same as the fresh flake template.

luaUtils

nix flake init -t github:BirdeeHub/nixCats-nvim#luaUtils

A template that includes Lua utils for using Neovim package managers when your config file is not loaded via Nix.

home-manager

nix flake init -t github:BirdeeHub/nixCats-nvim#home-manager

Demonstration of importing and using the nixCats module for Home Manager.

nixos

nix flake init -t github:BirdeeHub/nixCats-nvim#nixos

Demonstration of importing and using the nixCats module for NixOS (and nix-darwin).

Same as the home-manager template, but has the options repeated for per-user configurations.

nixExpressionFlakeOutputs

nix flake init -t github:BirdeeHub/nixCats-nvim#nixExpressionFlakeOutputs

How to import as just the outputs section of the flake, so that you can export its outputs with your system outputs.

It is best practice to avoid using the system pkgs and its overlays in this method, as then you could not output packages for systems not defined in your system flake. It creates a new one instead to use, just like the fresh flake template does.

Call it from your system flake and call it with inputs as arguments.

example

nix flake init -t github:BirdeeHub/nixCats-nvim#example

An idiomatic nixCats example configuration using lze for lazy loading and paq.nvim for backup when not using nixCats-nvim.

See also templates/example/README.md.

kickstart-nvim

nix flake init -t github:BirdeeHub/nixCats-nvim#kickstart-nvim

The entirety of kickstart.nvim implemented as a nixCats flake. With additional Nix LSPs for editing the Nix part. This is to serve as the tutorial for using the nixCats lazy wrapper.

See also templates/kickstart-nvim/README.md.

LazyVim

nix flake init -t github:BirdeeHub/nixCats-nvim#LazyVim

How to get the LazyVim distribution up and running. See the kickstart-nvim template for more info on the lazy wrapper or other utilities used.

fresh

nix flake init -t github:BirdeeHub/nixCats-nvim#fresh

Starting point template for making your Neovim flake.

overlayFile

nix flake init -t github:BirdeeHub/nixCats-nvim#overlayFile

A template for an empty overlay file defined as described in :help nixCats.flake.nixperts.overlays.

overlayHub

nix flake init -t github:BirdeeHub/nixCats-nvim#overlayHub

A template for overlays/default.nix. See :help nixCats.flake.nixperts.overlays.

overriding

nix flake init -t github:BirdeeHub/nixCats-nvim#overriding

How to RECONFIGURE nixCats WITHOUT DUPLICATION, given only an existing nixCats package, achieved via the OVERRIDE function.

In addition, it is also a demonstration of how to export a nixCats configuration as an AppImage.

It is a two-for-one example of two SEPARATE things one could do.

overwrite

nix flake init -t github:BirdeeHub/nixCats-nvim#overwrite

How to CONFIGURE nixCats FROM SCRATCH, given only an existing nixCats package, achieved via the OVERRIDE function.

Equivalent to the default flake template or nixExpressionFlakeOutputs except for using overrides.

Every nixCats package is a full nixCats-nvim.

Note for zsh users:

If using zsh with extendedglob AND nomatch options turned on, you will need to escape the # in Nix Flake commands.

Disabling one or both of them with unsetopt is a more long term solution.