NixOS & Flakes Book is a beginner-friendly tutorial that teaches NixOS and the Flakes experimental feature through detailed explanations and practical examples.
The book addresses the challenge of learning NixOS and Flakes, which represent significant changes to the Nix ecosystem. Flakes introduces dependency management policies for Nix expressions and improves reproducibility, composability, and usability. The author created this resource because no comprehensive beginner-oriented guide existed at the time, filling a gap in the community's documentation by providing an opinionated, hands-on approach to understanding these tools.
This tutorial suits developers new to NixOS who want structured guidance on adopting Flakes. The book is available in multiple languages, including English and Chinese as author-maintained versions, with community translations in Portuguese, Japanese, and Spanish. For macOS users, the author recommends pairing this book with a separate nix-darwin starter project. Readers should understand that while Flakes has broad community adoption and is unlikely to be deprecated, it remains officially experimental and may introduce breaking changes during stabilization.
The project actively solicits feedback through GitHub issues and discussions, with the author explicitly acknowledging the possibility of misconceptions in the content and inviting corrections. Contributions are welcomed through pull requests with a formal contributing guidelines document. The development reflects a collaborative approach where the author maintains the primary versions while the community extends the book into additional languages, indicating sustained engagement across multiple maintainers.
