From e07fdd117d6a4bb7088d0285f3f3b688f940c839 Mon Sep 17 00:00:00 2001
From: Peter Steinberger <steipete@gmail.com>
Date: Sun, 4 Jan 2026 00:36:48 +0100
Subject: [PATCH] docs: migrate Mintlify config

---
 docs/docs.json | 86 ++++++++++++++++++++++++++++++++++++++++++++++++++
 docs/mint.json | 82 -----------------------------------------------
 package.json   |  2 ++
 3 files changed, 88 insertions(+), 82 deletions(-)
 create mode 100644 docs/docs.json
 delete mode 100644 docs/mint.json

diff --git a/docs/docs.json b/docs/docs.json
new file mode 100644
index 000000000..7ebecfc70
--- /dev/null
+++ b/docs/docs.json
@@ -0,0 +1,86 @@
+{
+  "$schema": "https://mintlify.com/docs.json",
+  "name": "Clawdis",
+  "theme": "mint",
+  "logo": {
+    "light": "/assets/pixel-lobster.svg",
+    "dark": "/assets/pixel-lobster.svg"
+  },
+  "favicon": "/assets/pixel-lobster.svg",
+  "colors": {
+    "primary": "#FF5A36"
+  },
+  "topbarLinks": [
+    {
+      "name": "GitHub",
+      "url": "https://github.com/steipete/clawdis"
+    },
+    {
+      "name": "Releases",
+      "url": "https://github.com/steipete/clawdis/releases"
+    }
+  ],
+  "navigation": {
+    "groups": [
+      {
+        "group": "Getting Started",
+        "pages": [
+          "index",
+          "onboarding",
+          "wizard",
+          "clawd",
+          "faq"
+        ]
+      },
+      {
+        "group": "Core Concepts",
+        "pages": [
+          "architecture",
+          "agent",
+          "session",
+          "rpc",
+          "queue",
+          "tools"
+        ]
+      },
+      {
+        "group": "Gateway & Providers",
+        "pages": [
+          "gateway",
+          "gateway/pairing",
+          "whatsapp",
+          "telegram",
+          "discord",
+          "imessage",
+          "webhook",
+          "gmail-pubsub"
+        ]
+      },
+      {
+        "group": "Platforms",
+        "pages": [
+          "mac/dev-setup",
+          "mac/menu-bar",
+          "mac/voicewake",
+          "ios/connect",
+          "android/connect",
+          "webchat",
+          "web"
+        ]
+      },
+      {
+        "group": "Operations",
+        "pages": [
+          "doctor",
+          "troubleshooting",
+          "logging",
+          "security",
+          "health",
+          "background-process",
+          "gateway-lock",
+          "remote"
+        ]
+      }
+    ]
+  }
+}
diff --git a/docs/mint.json b/docs/mint.json
deleted file mode 100644
index 5a2eabf67..000000000
--- a/docs/mint.json
+++ /dev/null
@@ -1,82 +0,0 @@
-{
-  "name": "Clawdis",
-  "logo": {
-    "light": "/assets/pixel-lobster.svg",
-    "dark": "/assets/pixel-lobster.svg"
-  },
-  "favicon": "/assets/pixel-lobster.svg",
-  "colors": {
-    "primary": "#FF5A36"
-  },
-  "topbarLinks": [
-    {
-      "name": "GitHub",
-      "url": "https://github.com/steipete/clawdis"
-    },
-    {
-      "name": "Releases",
-      "url": "https://github.com/steipete/clawdis/releases"
-    }
-  ],
-  "navigation": [
-    {
-      "group": "Getting Started",
-      "pages": [
-        "index",
-        "onboarding",
-        "wizard",
-        "clawd",
-        "faq"
-      ]
-    },
-    {
-      "group": "Core Concepts",
-      "pages": [
-        "architecture",
-        "agent",
-        "session",
-        "rpc",
-        "queue",
-        "tools"
-      ]
-    },
-    {
-      "group": "Gateway & Providers",
-      "pages": [
-        "gateway",
-        "gateway/pairing",
-        "whatsapp",
-        "telegram",
-        "discord",
-        "imessage",
-        "webhook",
-        "gmail-pubsub"
-      ]
-    },
-    {
-      "group": "Platforms",
-      "pages": [
-        "mac/dev-setup",
-        "mac/menu-bar",
-        "mac/voicewake",
-        "ios/connect",
-        "android/connect",
-        "webchat",
-        "web"
-      ]
-    },
-    {
-      "group": "Operations",
-      "pages": [
-        "doctor",
-        "troubleshooting",
-        "logging",
-        "security",
-        "health",
-        "background-process",
-        "gateway-lock",
-        "remote"
-      ]
-    }
-  ]
-}
diff --git a/package.json b/package.json
index f46061bc9..8ce251344 100644
--- a/package.json
+++ b/package.json
@@ -38,6 +38,8 @@
   "scripts": {
     "dev": "tsx src/index.ts",
     "docs:list": "tsx scripts/docs-list.ts",
+    "docs:dev": "cd docs && mint dev",
+    "docs:build": "cd docs && mint broken-links",
     "build": "tsc -p tsconfig.json && tsx scripts/canvas-a2ui-copy.ts",
     "release:check": "tsx scripts/release-check.ts",
     "ui:install": "pnpm -C ui install",