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
Revert "fix: Revert "docs: add source links to examples (#391)" (#394)"
This reverts commit 118f95bc792a3f9f6b802669bcbf3683cab75395.
+62
+7
docs/src/content/docs/tutorials/bogus.md
docs/src/content/docs/tutorials/bogus.mdx
+7
docs/src/content/docs/tutorials/bogus.md
docs/src/content/docs/tutorials/bogus.mdx
···
3
3
description: Create minimal reproductions for Den bug reports using nix-unit.
4
4
---
5
5
6
+
7
+
import { Aside } from '@astrojs/starlight/components';
8
+
9
+
<Aside title="Source" icon="github">
10
+
[`templates/bogus`](https://github.com/vic/den/tree/main/templates/bogus)
11
+
</Aside>
12
+
6
13
The bogus template helps you create minimal bug reproductions. Use it when reporting issues or contributing fixes.
7
14
8
15
## Initialize
+7
docs/src/content/docs/tutorials/ci.md
docs/src/content/docs/tutorials/ci.mdx
+7
docs/src/content/docs/tutorials/ci.md
docs/src/content/docs/tutorials/ci.mdx
···
3
3
description: Den's own test suite — the definitive reference for every feature.
4
4
---
5
5
6
+
7
+
import { Aside } from '@astrojs/starlight/components';
8
+
9
+
<Aside title="Source" icon="github">
10
+
[`templates/ci`](https://github.com/vic/den/tree/main/templates/ci)
11
+
</Aside>
12
+
6
13
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
14
8
15
## Structure
+7
docs/src/content/docs/tutorials/default.md
docs/src/content/docs/tutorials/default.mdx
+7
docs/src/content/docs/tutorials/default.md
docs/src/content/docs/tutorials/default.mdx
···
3
3
description: Recommended starting point with flake-parts, Home-Manager, and VM testing.
4
4
---
5
5
6
+
7
+
import { Aside } from '@astrojs/starlight/components';
8
+
9
+
<Aside title="Source" icon="github">
10
+
[`templates/default`](https://github.com/vic/den/tree/main/templates/default)
11
+
</Aside>
12
+
6
13
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
14
8
15
## Initialize
+7
docs/src/content/docs/tutorials/example.md
docs/src/content/docs/tutorials/example.mdx
+7
docs/src/content/docs/tutorials/example.md
docs/src/content/docs/tutorials/example.mdx
···
3
3
description: Feature showcase with namespaces, angle brackets, cross-platform aspects, and providers.
4
4
---
5
5
6
+
7
+
import { Aside } from '@astrojs/starlight/components';
8
+
9
+
<Aside title="Source" icon="github">
10
+
[`templates/example`](https://github.com/vic/den/tree/main/templates/example)
11
+
</Aside>
12
+
6
13
The example template demonstrates Den's advanced features: namespaces, angle brackets, cross-platform hosts, mutual providers, and custom aspect libraries.
7
14
8
15
## Initialize
+7
docs/src/content/docs/tutorials/flake-parts-modules.md
docs/src/content/docs/tutorials/flake-parts-modules.mdx
+7
docs/src/content/docs/tutorials/flake-parts-modules.md
docs/src/content/docs/tutorials/flake-parts-modules.mdx
···
3
3
description: Den Forwarding classes for third-party flake-parts perSystem submodules.
4
4
---
5
5
6
+
7
+
import { Aside } from '@astrojs/starlight/components';
8
+
9
+
<Aside title="Source" icon="github">
10
+
[`templates/flake-parts-modules`](https://github.com/vic/den/tree/main/templates/flake-parts-modules)
11
+
</Aside>
12
+
6
13
The `flake-parts-modules` template demonstrates how to use Den aspects
7
14
that propagate custom classes into third-party flake-parts `perSystem` modules.
8
15
+7
docs/src/content/docs/tutorials/microvm.md
docs/src/content/docs/tutorials/microvm.mdx
+7
docs/src/content/docs/tutorials/microvm.md
docs/src/content/docs/tutorials/microvm.mdx
···
3
3
description: Feature showcase MicroVM integration with custom context pipelines and custom classes.
4
4
---
5
5
6
+
7
+
import { Aside } from '@astrojs/starlight/components';
8
+
9
+
<Aside title="Source" icon="github">
10
+
[`templates/microvm`](https://github.com/vic/den/tree/main/templates/microvm)
11
+
</Aside>
12
+
6
13
[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
14
8
15
This template shows two patterns for building MicroVMs with Den.
+7
docs/src/content/docs/tutorials/minimal.md
docs/src/content/docs/tutorials/minimal.mdx
+7
docs/src/content/docs/tutorials/minimal.md
docs/src/content/docs/tutorials/minimal.mdx
···
3
3
description: The smallest possible Den setup — one host, one user, no extra dependencies.
4
4
---
5
5
6
+
7
+
import { Aside } from '@astrojs/starlight/components';
8
+
9
+
<Aside title="Source" icon="github">
10
+
[`templates/minimal`](https://github.com/vic/den/tree/main/templates/minimal)
11
+
</Aside>
12
+
6
13
The minimal template demonstrates Den's core with zero extra dependencies beyond nixpkgs.
7
14
8
15
## Initialize
+7
docs/src/content/docs/tutorials/noflake.md
docs/src/content/docs/tutorials/noflake.mdx
+7
docs/src/content/docs/tutorials/noflake.md
docs/src/content/docs/tutorials/noflake.mdx
···
3
3
description: Using Den with stable Nix — no flakes needed.
4
4
---
5
5
6
+
7
+
import { Aside } from '@astrojs/starlight/components';
8
+
9
+
<Aside title="Source" icon="github">
10
+
[`templates/noflake`](https://github.com/vic/den/tree/main/templates/noflake)
11
+
</Aside>
12
+
6
13
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
14
8
15
## Initialize
+6
docs/src/content/docs/tutorials/nvf-standalone.md
docs/src/content/docs/tutorials/nvf-standalone.mdx
+6
docs/src/content/docs/tutorials/nvf-standalone.md
docs/src/content/docs/tutorials/nvf-standalone.mdx
···
3
3
description: Den based NVF configuration without NixOS
4
4
---
5
5
6
+
import { Aside } from '@astrojs/starlight/components';
7
+
8
+
<Aside title="Source" icon="github">
9
+
[`templates/nvf-standalone`](https://github.com/vic/den/tree/main/templates/nvf-standalone)
10
+
</Aside>
11
+
6
12
The `nvf-standalone` template demonstrates how to use Den for
7
13
other configurations outside NixOS/nix-Darwin/HM. For demo
8
14
purposes this uses [NVF Standalone](https://nvf.notashelf.dev/#ch-standalone-installation) to configure a runnable `.#my-neovim` app.
docs/src/content/docs/tutorials/overview.md
docs/src/content/docs/tutorials/overview.mdx
docs/src/content/docs/tutorials/overview.md
docs/src/content/docs/tutorials/overview.mdx