From e7e62d6bb36207b6a004cf5fc643073dcc8f7d55 Mon Sep 17 00:00:00 2001
From: "fkrebs (via Claude)" <fkrebs@nucli.de>
Date: Wed, 20 May 2026 23:55:43 +0200
Subject: [PATCH] docs: add mkdocs.yml (Material theme)

---
 mkdocs.yml | 65 ++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 65 insertions(+)
 create mode 100644 mkdocs.yml

diff --git a/mkdocs.yml b/mkdocs.yml
new file mode 100644
index 0000000..0281104
--- /dev/null
+++ b/mkdocs.yml
@@ -0,0 +1,65 @@
+site_name: nuclide.systems docs
+site_description: Single source of truth for the homelab
+site_url: https://docs.nuclide.systems
+
+theme:
+  name: material
+  palette:
+    - media: "(prefers-color-scheme: dark)"
+      scheme: slate
+      primary: black
+      accent: blue
+    - media: "(prefers-color-scheme: light)"
+      scheme: default
+      primary: black
+      accent: blue
+  features:
+    - navigation.tabs
+    - navigation.sections
+    - navigation.expand
+    - navigation.top
+    - search.highlight
+    - search.suggest
+    - content.code.copy
+
+markdown_extensions:
+  - admonition
+  - pymdownx.details
+  - pymdownx.highlight:
+      anchor_linenums: true
+  - pymdownx.superfences
+  - pymdownx.tabbed:
+      alternate_style: true
+  - tables
+  - toc:
+      permalink: true
+
+nav:
+  - Home: README.md
+  - Changelog: CHANGELOG.md
+  - CT inventory: ct-inventory.md
+  - Infra:
+      - Proxmox state: infra/proxmox-state.md
+  - Services:
+      - Homelab architecture: services/homelab-architecture.md
+      - Dev environment (Coder + Gitea): services/dev-environment.md
+      - MCP gateway: services/mcp-gateway.md
+      - ComfyUI: services/comfyui.md
+      - Zoraxy: services/zoraxy.md
+      - AdGuard DNS: services/adguard-dns.md
+      - Cloud GPU: services/cloud-gpu.md
+  - Stacks (CT 104):
+      - PORTMAP: stacks/PORTMAP.md
+      - Storage: stacks/storage.md
+      - Volumes: stacks/volumes.md
+      - Docker networks: stacks/docker-networks.md
+      - TODO: stacks/todo.md
+      - Agent notes: stacks/CLAUDE.md
+  - Ideas:
+      - Stack ideas: ideas/stack-ideas.md
+  - History:
+      - Traefik (abandoned 2026-05-16): history/traefik-migration.md
+      - Traefik labels (abandoned): history/traefik-migration-docker-labels.md
+      - MCP gateway requirements (superseded): history/mcp-gateway-requirements.md
+      - Scrubbing list (2026-05-17): history/scrubbing-list-2026-05-17.md
+      - Case study: history/case-study.md