Documentation Overview

Learn

Understand the principles and mechanisms behind Den.

Core Principles Dendritic design: features over hosts, aspects over modules.

Context System How den.ctx types define data flow between entities.

Aspects & Functors The __functor pattern and aspect structure.

Parametric Aspects Context-aware function dispatch via argument introspection.

Context Pipeline How host/user/home contexts transform into NixOS/Darwin/HM modules.

Library vs Framework Using Den's core lib for any Nix domain.

Practical recipes for common tasks.

Declare Hosts & Users den.hosts, den.homes, users, and schema options.

Configure Aspects Owned configs, includes, provides, and defaults.

Custom Nix Classes Create new classes via den.provides.forward.

Homes Integration Home Manager, hjem, and nix-maid setup.

Use Batteries den.provides.* built-in aspects.

Share with Namespaces Publish and consume aspect libraries across flakes.

Angle Brackets Syntax shorthand via __findFile.

Migrate to Den Incremental migration from existing setups.

Debug Configurations REPL inspection, tracing, and troubleshooting.

Step-by-step walkthroughs for each starter template.

Templates Overview Comparison of all available templates.

Default Recommended: flake-parts + home-manager.

Minimal Minimal flake, no flake-parts.

Example Cross-platform NixOS + Darwin.

No-Flake npins + lib.evalModules.

CI Tests Feature tests as executable code examples.

Bug Reproduction Isolated template for bug reports.

API documentation for every Den option.

den.ctx Context types, into transformations, provides.

den.lib parametric, canTake, take, statics, owned, __findFile.

den.aspects Aspect type, resolution, class configs.

den.schema Host, user, home schema options.

den.provides Built-in batteries reference.

flake.* Output generation and instantiation.

Community Discussions, real-world examples, ecosystem.

Contributing Tests, CI, code style.

Sponsor Support Den development.