Modular, context-aware and aspect-oriented dendritic Nix configurations.
Discussions: https://oeiuwq.zulipchat.com/join/nqp26cd4kngon6mo3ncgnuap/
den.oeiuwq.com
configurations
den
dendritic
nix
aspect
oriented
docs: add source links to examples (#391)
authored by
Michael Utz
and committed by
GitHub
f056aeef
6f4179c4
+36
+4
docs/src/content/docs/tutorials/bogus.md
+4
docs/src/content/docs/tutorials/bogus.md
···
3
3
description: Create minimal reproductions for Den bug reports using nix-unit.
4
4
---
5
5
6
+
<Aside title="Source" icon="github">
7
+
[`templates/bogus`](https://github.com/vic/den/tree/main/templates/bogus)
8
+
</Aside>
9
+
6
10
The bogus template helps you create minimal bug reproductions. Use it when reporting issues or contributing fixes.
7
11
8
12
## Initialize
+4
docs/src/content/docs/tutorials/ci.md
+4
docs/src/content/docs/tutorials/ci.md
···
3
3
description: Den's own test suite — the definitive reference for every feature.
4
4
---
5
5
6
+
<Aside title="Source" icon="github">
7
+
[`templates/ci`](https://github.com/vic/den/tree/main/templates/ci)
8
+
</Aside>
9
+
6
10
The CI template is Den's comprehensive test suite. It tests every feature using [nix-unit](https://github.com/nix-community/nix-unit). This is the **best learning resource** for understanding exactly how Den behaves.
7
11
8
12
## Structure
+4
docs/src/content/docs/tutorials/default.md
+4
docs/src/content/docs/tutorials/default.md
···
3
3
description: Recommended starting point with flake-parts, Home-Manager, and VM testing.
4
4
---
5
5
6
+
<Aside title="Source" icon="github">
7
+
[`templates/default`](https://github.com/vic/den/tree/main/templates/default)
8
+
</Aside>
9
+
6
10
The default template is the recommended way to start a new Den project. It includes flake-parts, Home-Manager, dendritic flake-file, and a VM for testing.
7
11
8
12
## Initialize
+4
docs/src/content/docs/tutorials/example.md
+4
docs/src/content/docs/tutorials/example.md
···
3
3
description: Feature showcase with namespaces, angle brackets, cross-platform aspects, and providers.
4
4
---
5
5
6
+
<Aside title="Source" icon="github">
7
+
[`templates/example`](https://github.com/vic/den/tree/main/templates/example)
8
+
</Aside>
9
+
6
10
The example template demonstrates Den's advanced features: namespaces, angle brackets, cross-platform hosts, mutual providers, and custom aspect libraries.
7
11
8
12
## Initialize
+4
docs/src/content/docs/tutorials/flake-parts-modules.md
+4
docs/src/content/docs/tutorials/flake-parts-modules.md
···
3
3
description: Den Forwarding classes for third-party flake-parts perSystem submodules.
4
4
---
5
5
6
+
<Aside title="Source" icon="github">
7
+
[`templates/flake-parts-modules`](https://github.com/vic/den/tree/main/templates/flake-parts-modules)
8
+
</Aside>
9
+
6
10
The `flake-parts-modules` template demonstrates how to use Den aspects
7
11
that propagate custom classes into third-party flake-parts `perSystem` modules.
8
12
+4
docs/src/content/docs/tutorials/microvm.md
+4
docs/src/content/docs/tutorials/microvm.md
···
3
3
description: Feature showcase MicroVM integration with custom context pipelines and custom classes.
4
4
---
5
5
6
+
<Aside title="Source" icon="github">
7
+
[`templates/microvm`](https://github.com/vic/den/tree/main/templates/microvm)
8
+
</Aside>
9
+
6
10
[templates/microvm](https://github.com/vic/den/tree/main/templates/microvm) demonstrates Den's extensibility: custom `den.ctx` and `den.schema` extensions for integrating other Nix libraries like [MicroVM.nix](https://github.com/microvm-nix/microvm.nix).
7
11
8
12
This template shows two patterns for building MicroVMs with Den.
+4
docs/src/content/docs/tutorials/minimal.md
+4
docs/src/content/docs/tutorials/minimal.md
···
3
3
description: The smallest possible Den setup — one host, one user, no extra dependencies.
4
4
---
5
5
6
+
<Aside title="Source" icon="github">
7
+
[`templates/minimal`](https://github.com/vic/den/tree/main/templates/minimal)
8
+
</Aside>
9
+
6
10
The minimal template demonstrates Den's core with zero extra dependencies beyond nixpkgs.
7
11
8
12
## Initialize
+4
docs/src/content/docs/tutorials/noflake.md
+4
docs/src/content/docs/tutorials/noflake.md
···
3
3
description: Using Den with stable Nix — no flakes needed.
4
4
---
5
5
6
+
<Aside title="Source" icon="github">
7
+
[`templates/noflake`](https://github.com/vic/den/tree/main/templates/noflake)
8
+
</Aside>
9
+
6
10
The noflake template shows that Den works perfectly without Nix flakes. It uses [npins](https://github.com/andir/npins) for dependency management and works with stable Nix.
7
11
8
12
## Initialize
+4
docs/src/content/docs/tutorials/nvf-standalone.md
+4
docs/src/content/docs/tutorials/nvf-standalone.md
···
3
3
description: Den based NVF configuration without NixOS
4
4
---
5
5
6
+
<Aside title="Source" icon="github">
7
+
[`templates/nvf-standalone`](https://github.com/vic/den/tree/main/templates/nvf-standalone)
8
+
</Aside>
9
+
6
10
The `nvf-standalone` template demonstrates how to use Den for
7
11
other configurations outside NixOS/nix-Darwin/HM. For demo
8
12
purposes this uses [NVF Standalone](https://nvf.notashelf.dev/#ch-standalone-installation) to configure a runnable `.#my-neovim` app.