nixpkgs-personal¶

This repository publishes maintained Nix packages through a flake and an overlay. Start with the package catalog to find a package and its supported platforms. The usage guide shows the direct flake interface and the current NUR status.

Package recipes live under pkgs/by-name/. A package-specific README documents behavior that does not belong in the catalog. The package standard defines the common interface and review rules. Licensing decisions remain in the licensing policy.

The website contains the stable package and maintenance documentation. Source, package-level notes, checks, and release history remain in the GitHub repository.

Use a package¶

Build a package without adding the repository to a configuration:

nix build github:nix-forge/nixpkgs-personal#PACKAGE

Pin the flake input before using a package in a system or home configuration. The repository's flake.lock pins development and validation dependencies; it does not pin a downstream consumer's input for them.

Maintain the documentation¶

Build the exact site artifact used by CI:

nix build .#checks.x86_64-linux.documentation-site

Preview documentation while editing:

nix develop .#docs --command mkdocs serve --config-file site/mkdocs.yml

MkDocs treats missing pages and anchors as build failures. Links to source files outside docs/ stay on GitHub and are not copied into the site.