Weyl Standard Nix

Weyl Standard Nix is a specification for building reproducible, composable infrastructure on Nix. Part of the Weyl Standard collection of language standards.

Core Principles

1. Flakes exclusively - No legacy Nix, no nix-shell, no NIX_PATH
2. flake-parts as foundation - Module system for flakes
3. nixos-unified structure - Autowiring over boilerplate
4. Overlays for packages - Centrally managed nixpkgs
5. lisp-case everywhere - Consistent naming across identifiers

Philosophy

• Why Nix — The case for reproducibility
• The Overlay — Universe transformers
• lisp-case — Naming convention rationale

Guides

Getting Started

• Installation — Prerequisites and setup
• First Flake — Your first conformant flake
• Infrastructure — Cachix, Hercules CI, Omnix

Patterns

• Naming Conventions — How to name things
• File Placement — Where things go
• Module Systems — flake-parts, NixOS, darwin
• Writing Packages — callPackage, finalAttrs
• Writing Modules — Options, config, mkIf
• Testing — nix flake check, NixOS tests
• Documentation — Comments, assertions, errors
• Forbidden Patterns — What not to do

Advanced

• Standard Environments — Custom build environments
• Overlays — Package set transformations
• Cross-Compilation — Multi-platform builds

RFCs

• RFC 001: Weyl Standard Nix — Core specification
• RFC 002: wsn-lint — Linting and enforcement

Reference

• Options — Configuration options
• Library — Utility functions

---

“The Nix model of reproducible builds, declarative configuration, and content-addressed storage is correct. The particular stylistic choices of nixpkgs are not load-bearing.”

— RFC-001