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
fix: Revert "docs: add source links to examples (#391)" (#394)
This reverts commit f056aeef952c8884507470aaf9a8227a05272067.
Revert "docs: import astro component into mdx (#392)"
This reverts commit 6c2f6f5ed5012f9e8ef5fab0f56bd67213c76275.
Revert "docs: actually rename to .mdx (#393)"
This reverts commit 16f9adcd0419fa3a9587a113fd21611efd58dd26.
authored by
Michael Utz
and committed by
GitHub
118f95bc
16f9adcd
-60
-7
docs/src/content/docs/tutorials/bogus.mdx
docs/src/content/docs/tutorials/bogus.md
-7
docs/src/content/docs/tutorials/bogus.mdx
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
-
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
-
13
6
The bogus template helps you create minimal bug reproductions. Use it when reporting issues or contributing fixes.
14
7
15
8
## Initialize
-7
docs/src/content/docs/tutorials/ci.mdx
docs/src/content/docs/tutorials/ci.md
-7
docs/src/content/docs/tutorials/ci.mdx
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
-
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
-
13
6
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.
14
7
15
8
## Structure
-7
docs/src/content/docs/tutorials/default.mdx
docs/src/content/docs/tutorials/default.md
-7
docs/src/content/docs/tutorials/default.mdx
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
-
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
-
13
6
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.
14
7
15
8
## Initialize
-7
docs/src/content/docs/tutorials/example.mdx
docs/src/content/docs/tutorials/example.md
-7
docs/src/content/docs/tutorials/example.mdx
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
-
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
-
13
6
The example template demonstrates Den's advanced features: namespaces, angle brackets, cross-platform hosts, mutual providers, and custom aspect libraries.
14
7
15
8
## Initialize
-7
docs/src/content/docs/tutorials/flake-parts-modules.mdx
docs/src/content/docs/tutorials/flake-parts-modules.md
-7
docs/src/content/docs/tutorials/flake-parts-modules.mdx
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
-
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
-
13
6
The `flake-parts-modules` template demonstrates how to use Den aspects
14
7
that propagate custom classes into third-party flake-parts `perSystem` modules.
15
8
-7
docs/src/content/docs/tutorials/microvm.mdx
docs/src/content/docs/tutorials/microvm.md
-7
docs/src/content/docs/tutorials/microvm.mdx
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
-
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
-
13
6
[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).
14
7
15
8
This template shows two patterns for building MicroVMs with Den.
-7
docs/src/content/docs/tutorials/minimal.mdx
docs/src/content/docs/tutorials/minimal.md
-7
docs/src/content/docs/tutorials/minimal.mdx
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
-
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
-
13
6
The minimal template demonstrates Den's core with zero extra dependencies beyond nixpkgs.
14
7
15
8
## Initialize
-7
docs/src/content/docs/tutorials/noflake.mdx
docs/src/content/docs/tutorials/noflake.md
-7
docs/src/content/docs/tutorials/noflake.mdx
docs/src/content/docs/tutorials/noflake.md
···
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
-
13
6
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.
14
7
15
8
## Initialize
-4
docs/src/content/docs/tutorials/nvf-standalone.mdx
docs/src/content/docs/tutorials/nvf-standalone.md
-4
docs/src/content/docs/tutorials/nvf-standalone.mdx
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
-
10
6
The `nvf-standalone` template demonstrates how to use Den for
11
7
other configurations outside NixOS/nix-Darwin/HM. For demo
12
8
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.mdx
docs/src/content/docs/tutorials/overview.md
docs/src/content/docs/tutorials/overview.mdx
docs/src/content/docs/tutorials/overview.md