Nix Docs

Plain-Markdown knowledge base for the full Nix stack: philosophy, language, store, nixpkgs, NixOS, flakes, experimental features, tooling, and current implementations.

Browse folders by number; each domain README.md lists its children. Conventions: meta/conventions.md.

Published site: https://zemdregon.github.io/nix-docs/ (MkDocs Material / GitHub Pages) — build notes in meta/site.md.

How to navigate

Start with 00-roadmap (beginner / operator / contributor), or jump by domain below. Prefer relative links between topics. Want a full working config story? 16-configuration-examples. Stuck? FAQ: common errors then Getting help and community. How to use upstream manuals: Reading manuals and search.

Domains

• 00-roadmap — Learning paths (beginner, operator, contributor)
• 01-philosophy — Design goals and tradeoffs
• 02-concepts — Core vocabulary (derivation, closure, flake, …)
• 03-language — Syntax, semantics, builtins, idioms
• 04-store-and-build — Store, builders, caches, GC
• 05-cli-and-tooling — Classic/modern CLI, config, adjacent tools
• 06-nixpkgs — Architecture, packaging, overlays, contribution
• 07-flakes — Schema, workflows, registries, migration
• 08-experimental-features — Feature flags and experiments
• 09-nixos — Modules, config, services, install, operations
• 10-home-and-user — Home Manager, nix-darwin, multi-distro Nix
• 11-development — Shells, CI, containers, tests
• 12-deployment-and-infra — Deploy tools, secrets, Hydra, caches
• 13-implementations — Evaluators, UX, ecosystems, frameworks
• 14-security-and-trust — Trust, sandboxes, secrets, signing
• 15-history-and-governance — Timeline, foundation, RFCs, community help
• 16-configuration-examples — Picture-perfect multi-file configs that compose the domains above

Cross-cutting

• glossary.md — Term index
• comparisons — Nix vs related tools and models
• cheatsheets — Dense quick references (FAQ)
• meta — Conventions, sources, coverage, site, example fixtures