From ec8e3aedb423c87dfea71382fd5cfcaad3f6e0d0 Mon Sep 17 00:00:00 2001
From: Soham Daga <85427822+sohamd22@users.noreply.github.com>
Date: Sat, 19 Sep 2026 22:42:08 -0700
Subject: [PATCH] chore(docs): run Mintlify development with Node 22 (#1692)

---
 apps/docs/package.json   |  2 +-
 apps/docs/scripts/dev.sh | 17 +++++++++++++++++
 2 files changed, 18 insertions(+), 1 deletion(-)
 create mode 100644 apps/docs/scripts/dev.sh

diff --git a/apps/docs/package.json b/apps/docs/package.json
index a3aff8c2..db13029c 100644
--- a/apps/docs/package.json
+++ b/apps/docs/package.json
@@ -6,7 +6,7 @@
   "portless": { "name": "docs.dev.supermemory", "script": "dev:app", "appPort": 3003 },
   "scripts": {
     "dev": "portless",
-    "dev:app": "bunx mintlify@latest dev --no-open --port 3003"
+    "dev:app": "bash scripts/dev.sh"
   },
   "devDependencies": {
     "@types/bun": "latest",
diff --git a/apps/docs/scripts/dev.sh b/apps/docs/scripts/dev.sh
new file mode 100644
index 00000000..9e56ed22
--- /dev/null
+++ b/apps/docs/scripts/dev.sh
@@ -0,0 +1,17 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+docs_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+docs_port="${PORT:-3003}"
+mintlify_args=(dev --no-open --port "$docs_port")
+
+printf -v docs_dir_escaped "%q" "$docs_dir"
+printf -v mintlify_args_escaped " %q" "${mintlify_args[@]}"
+
+# Run outside the monorepo so npx does not pick up Mintlify's Bun-installed
+# dependency tree, which is incompatible with its Node-based schema compiler.
+cd /tmp
+exec npx --yes \
+  --package node@22 \
+  --package mintlify@latest \
+  --call "cd $docs_dir_escaped && mintlify$mintlify_args_escaped"