{"simplified_version":"0.1.295","repo_url":"https://github.com/nixcafe/cattery-modules","source_subdirectory":null,"org":"nixcafe","project":"cattery-modules","version":"0.1.295+rev-ad27e52d8632afef4bf95c97a32189f3263ee318","description":null,"readme":"

cattery-modules

\n

\n A curated collection of 244+ Nix modules — choose a room, enable it, and get a complete system with theming, desktop, gaming, server, dev tools, and more.\n
\n cattery.nixcafe.org\n

\n

\n \"FlakeHub\"\n \"License\"\n

\n
\n

Quick Start

\n
# flake.nix\n{\n  inputs.cattery-modules.url = \"https://flakehub.com/f/nixcafe/cattery-modules/*.tar.gz\";\n\n  outputs = { nixpkgs, cattery-modules, ... }: {\n    nixosConfigurations.myhost = nixpkgs.lib.nixosSystem {\n      modules = [ cattery-modules.nixosModules.default ];\n    };\n  };\n}\n
\n
# configuration.nix\n{ config, ... }: {\n  cattery.room.desktop.dev.enable = true;\n}\n
\n

One line — full developer desktop. nixos-rebuild switch, done.

\n

What is cattery?

\n

cattery provides rooms (pre-configured module bundles) and 244+ individual modules for NixOS, nix-darwin, home-manager, and NixOS-WSL. Enable a room and get dozens of modules with sensible defaults. Override anything you want.

\n
room.basis                          # mtr, nix-ld, cron, openssh, locale, network, time, kernel\n └─ room.general                    # basis + boot.efi\n     ├─ room.server-mini            # basis + cloud-init, qemu-guest, acme\n     │   └─ room.server             # basis + server-mini (passthrough)\n     ├─ room.container              # basis + acme, boot.isContainer\n     └─ room.desktop.basis          # basis + automount, wireless, peripherals, fonts, fcitx5\n          └─ room.desktop.general   # desktop.basis + boot.efi\n               ├─ room.desktop.dev  # desktop.general + yubikey, docker, vscode-server\n               ├─ room.desktop.game # desktop.general + steam\n               └─ room.desktop.wsl  # desktop.basis + wsl\n\nroom.game                           # standalone (home-manager): basis + vscode, zed, messengers, video\n
\n

Features

\n\n

Module Categories

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
CategoryHighlights
ThemingCatppuccin (GTK, Qt, Plasma, Hyprland, SDDM)
DesktopHyprland (charm-cat & caelestia themes), Niri, GNOME, KDE Plasma
GamingSteam, AMD GPU, game launchers
Securityagenix, impermanence, Secure Boot (lanzaboote), YubiKey, GPG
Servicesnginx, PostgreSQL, Forgejo, Gitea, Tailscale, Vaultwarden, Docker
Dev ToolsVS Code, JetBrains, all dev-kits (git, rust, go, java, js, cpp, lua, wasm), Ollama
Shell & CLIfish, zsh, nushell, direnv, starship, atuin, yazi, neovim, helix
PlatformNixOS-WSL, Proxmox LXC, nix-darwin
\n

Picking Individual Modules

\n
cattery = {\n  themes.catppuccin.enable = true;\n  desktop.hyprland.enable = true;\n  services.tailscale.enable = true;\n  cli-apps.dev-kit.git.enable = true;\n  cli-apps.dev-kit.rust.enable = true;\n};\n
\n

Customizing Rooms

\n

All sub-module enables use lib.mkDefault — your overrides always win:

\n
cattery.room.desktop.dev.enable = true;\ncattery.apps.jetbrains.enable = false;       # I prefer neovim\ncattery.desktop.hyprland.enable = false;     # I prefer Niri\ncattery.desktop.niri.enable = true;\n
\n

Development

\n
nix develop     # enter dev shell (nixfmt, deadnix, statix)\nnix flake check # lint + eval all 244+ modules\nnix fmt         # format all files\n
\n

Documentation

\n

Full documentation at cattery.nixcafe.org — quick start, room hierarchy, full module catalog, secrets guide, and contributing.

\n

License

\n

CC0 1.0 Universal

\n","revision":"ad27e52d8632afef4bf95c97a32189f3263ee318","visibility":"public","spdx_identifier":"CC0-1.0","labels":["nixos-wsl","agenix","home-manager","nixos","nix-darwin","nix-modules","catppuccin","nix"],"mirrored":false,"created_at":"2024-10-12T15:32:26.072823Z","outputs":{"checks":{"name":"checks","doc":"The `checks` flake output contains derivations that will be built by `nix flake check`.\n","outputs":[{"platform":"aarch64-darwin","outputs":[{"path":["checks","aarch64-darwin","git-hooks"],"short_description":"","doc":null,"what":"CI test","for_systems":["aarch64-darwin"],"store_paths":{"out":"/nix/store/77ngc6n4sp0bcqrdg42ds481pmlvidsl-pre-commit-run"}},{"path":["checks","aarch64-darwin","module-eval"],"short_description":"","doc":null,"what":"CI test","for_systems":["aarch64-darwin"],"store_paths":{"out":"/nix/store/2pgkvdl6kzbm9fd3rzxd4q3vqa4hhffa-check-module-eval"}}]},{"platform":"aarch64-linux","outputs":[{"path":["checks","aarch64-linux","git-hooks"],"short_description":"","doc":null,"what":"CI test","for_systems":["aarch64-linux"],"store_paths":{"out":"/nix/store/4cznmncbiivq95s0rfq8x6q1zy0zpg2n-pre-commit-run"}},{"path":["checks","aarch64-linux","module-eval"],"short_description":"","doc":null,"what":"CI test","for_systems":["aarch64-linux"],"store_paths":{"out":"/nix/store/l0irm32nncmkjxzsxccnllfcigmm8xl6-check-module-eval"}}]},{"platform":"x86_64-linux","outputs":[{"path":["checks","x86_64-linux","git-hooks"],"short_description":"","doc":null,"what":"CI test","for_systems":["x86_64-linux"],"store_paths":{"out":"/nix/store/1xm0yxgwv42g60d8iqwx4j0f70wi96fh-pre-commit-run"}},{"path":["checks","x86_64-linux","module-eval"],"short_description":"","doc":null,"what":"CI test","for_systems":["x86_64-linux"],"store_paths":{"out":"/nix/store/l0w6m6p9xlmr6wy9d1mnpkp3ilvgx3p7-check-module-eval"}}]}]},"formatter":{"name":"formatter","doc":"The `formatter` output specifies the package to use to format the project.\n","outputs":[{"platform":"aarch64-darwin","outputs":[{"path":["formatter","aarch64-darwin"],"short_description":"Official formatter for Nix code","doc":null,"what":"formatter","for_systems":["aarch64-darwin"],"store_paths":{"out":"/nix/store/958q1ady98nwszsx9z44f1hbk0wid50f-nixfmt-1.4.0"}}]},{"platform":"aarch64-linux","outputs":[{"path":["formatter","aarch64-linux"],"short_description":"Official formatter for Nix code","doc":null,"what":"formatter","for_systems":["aarch64-linux"],"store_paths":{"out":"/nix/store/fvp14q5301x0l6m3x3wbwiz40q2144nd-nixfmt-1.4.0"}}]},{"platform":"x86_64-linux","outputs":[{"path":["formatter","x86_64-linux"],"short_description":"Official formatter for Nix code","doc":null,"what":"formatter","for_systems":["x86_64-linux"],"store_paths":{"out":"/nix/store/81mvb88s7l4ciq2sicr0zsadazkd49yn-nixfmt-1.4.0"}}]}]},"darwinModules":{"name":"darwinModules","doc":"The `darwinModules` flake output defines importable [nix-darwin modules](https://github.com/nix-darwin/nix-darwin).\n","outputs":[{"platform":null,"outputs":[{"path":["darwinModules","default"],"short_description":null,"doc":null,"what":"nix-darwin module","for_systems":[null],"store_paths":{}},{"path":["darwinModules","apps"],"short_description":null,"doc":null,"what":"nix-darwin module","for_systems":[null],"store_paths":{}},{"path":["darwinModules","brew"],"short_description":null,"doc":null,"what":"nix-darwin module","for_systems":[null],"store_paths":{}},{"path":["darwinModules","cli-apps"],"short_description":null,"doc":null,"what":"nix-darwin module","for_systems":[null],"store_paths":{}},{"path":["darwinModules","home"],"short_description":null,"doc":null,"what":"nix-darwin module","for_systems":[null],"store_paths":{}},{"path":["darwinModules","nix"],"short_description":null,"doc":null,"what":"nix-darwin module","for_systems":[null],"store_paths":{}},{"path":["darwinModules","room"],"short_description":null,"doc":null,"what":"nix-darwin module","for_systems":[null],"store_paths":{}},{"path":["darwinModules","secrets"],"short_description":null,"doc":null,"what":"nix-darwin module","for_systems":[null],"store_paths":{}},{"path":["darwinModules","services"],"short_description":null,"doc":null,"what":"nix-darwin module","for_systems":[null],"store_paths":{}},{"path":["darwinModules","system"],"short_description":null,"doc":null,"what":"nix-darwin module","for_systems":[null],"store_paths":{}},{"path":["darwinModules","user"],"short_description":null,"doc":null,"what":"nix-darwin module","for_systems":[null],"store_paths":{}}]}]},"homeModules":{"name":"homeModules","doc":"The `homeModules` flake output defines importable [Home Manager](https://github.com/nix-community/home-manager) modules.\n","outputs":[{"platform":null,"outputs":[{"path":["homeModules","default"],"short_description":null,"doc":null,"what":"Home Manager module","for_systems":[null],"store_paths":{}},{"path":["homeModules","darwin"],"short_description":null,"doc":null,"what":"Home Manager module","for_systems":[null],"store_paths":{}},{"path":["homeModules","nixos"],"short_description":null,"doc":null,"what":"Home Manager module","for_systems":[null],"store_paths":{}},{"path":["homeModules","room"],"short_description":null,"doc":null,"what":"Home Manager module","for_systems":[null],"store_paths":{}},{"path":["homeModules","shared"],"short_description":null,"doc":null,"what":"Home Manager module","for_systems":[null],"store_paths":{}},{"path":["homeModules","user"],"short_description":null,"doc":null,"what":"Home Manager module","for_systems":[null],"store_paths":{}}]}]},"devShells":{"name":"devShells","doc":"The `devShells` flake output contains derivations that provide a development environment for `nix develop`.\n","outputs":[{"platform":"aarch64-darwin","outputs":[{"path":["devShells","aarch64-darwin","default"],"short_description":"","doc":null,"what":"development environment","for_systems":["aarch64-darwin"],"store_paths":{"out":"/nix/store/42rqyw2hmxm675j6d2jlv4yzxyv9x7il-nix-shell"}}]},{"platform":"aarch64-linux","outputs":[{"path":["devShells","aarch64-linux","default"],"short_description":"","doc":null,"what":"development environment","for_systems":["aarch64-linux"],"store_paths":{"out":"/nix/store/cnsqpac95rv044z6q82idxhlgss7x84w-nix-shell"}}]},{"platform":"x86_64-linux","outputs":[{"path":["devShells","x86_64-linux","default"],"short_description":"","doc":null,"what":"development environment","for_systems":["x86_64-linux"],"store_paths":{"out":"/nix/store/qiqp7i6x5fw9bwqv2w0asmdx3ifxmjch-nix-shell"}}]}]},"nixosModules":{"name":"nixosModules","doc":"The `nixosModules` flake output defines importable [NixOS modules](https://nixos.org/manual/nixos/stable/#sec-writing-modules).\n","outputs":[{"platform":null,"outputs":[{"path":["nixosModules","default"],"short_description":null,"doc":null,"what":"NixOS module","for_systems":[null],"store_paths":{}},{"path":["nixosModules","apps"],"short_description":null,"doc":null,"what":"NixOS module","for_systems":[null],"store_paths":{}},{"path":["nixosModules","cli-apps"],"short_description":null,"doc":null,"what":"NixOS module","for_systems":[null],"store_paths":{}},{"path":["nixosModules","containers"],"short_description":null,"doc":null,"what":"NixOS module","for_systems":[null],"store_paths":{}},{"path":["nixosModules","desktop"],"short_description":null,"doc":null,"what":"NixOS module","for_systems":[null],"store_paths":{}},{"path":["nixosModules","home"],"short_description":null,"doc":null,"what":"NixOS module","for_systems":[null],"store_paths":{}},{"path":["nixosModules","nix"],"short_description":null,"doc":null,"what":"NixOS module","for_systems":[null],"store_paths":{}},{"path":["nixosModules","room"],"short_description":null,"doc":null,"what":"NixOS module","for_systems":[null],"store_paths":{}},{"path":["nixosModules","secrets"],"short_description":null,"doc":null,"what":"NixOS module","for_systems":[null],"store_paths":{}},{"path":["nixosModules","security"],"short_description":null,"doc":null,"what":"NixOS module","for_systems":[null],"store_paths":{}},{"path":["nixosModules","services"],"short_description":null,"doc":null,"what":"NixOS module","for_systems":[null],"store_paths":{}},{"path":["nixosModules","system"],"short_description":null,"doc":null,"what":"NixOS module","for_systems":[null],"store_paths":{}},{"path":["nixosModules","user"],"short_description":null,"doc":null,"what":"NixOS module","for_systems":[null],"store_paths":{}}]}]}},"avatar_url":"https://avatars.githubusercontent.com/u/181582751","all_yanked":false,"download_url":"https://api.flakehub.com/f/nixcafe/cattery-modules/0.1.295+rev-ad27e52d8632afef4bf95c97a32189f3263ee318.tar.gz","pretty_download_url":"https://flakehub.com/f/nixcafe/cattery-modules/0.1.295.tar.gz","source_github_owner_repo_pair":"nixcafe/cattery-modules"}