chore: move to wrangler for deployments

Author: avivkeller

.github/workflows/docs.yml

@@ -21,7 +21,9 @@
     "prepare": "husky || exit 0",
     "run": "node packages/cli/bin/cli.mjs",
     "watch": "node --watch packages/cli/bin/cli.mjs",
-    "docs:build": "bash scripts/vercel-docs-build.sh",
+    "build:site": "bash scripts/deployments/site/main.sh",
+    "build:beta": "bash scripts/deployments/beta/main.sh",
+    "build": "node --run build:site",
     "changeset": "changeset",
     "changeset:version": "changeset version",
     "release": "changeset publish"

.vercelignore

@@ -0,0 +1,52 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+readonly NODE_REPO="https://github.com/nodejs/node.git"
+readonly SRC_DIR="node"
+readonly OUT_DIR="out"
+
+cleanup() { rm -rf "$SRC_DIR"; }
+trap cleanup EXIT
+
+tags=$(git ls-remote --tags --refs --sort='-v:refname' "$NODE_REPO" 'v*')
+LATEST_TAG=$(awk -F/ '$NF !~ /-/ { print $NF; exit }' <<<"$tags")
+
+if [[ -z $LATEST_TAG ]]; then
+  echo "Could not determine the latest nodejs/node release tag" >&2
+  exit 1
+fi
+
+echo "Building docs for nodejs/node $LATEST_TAG"
+
+clone_node_docs() {
+  rm -rf "$SRC_DIR"
+  git clone --depth 1 --no-tags --branch "$LATEST_TAG" \
+    --filter=blob:none --sparse "$NODE_REPO" "$SRC_DIR"
+  git -C "$SRC_DIR" sparse-checkout set doc lib
+}
+
+clone_node_docs &
+clone_pid=$!
+
+pnpm install --frozen-lockfile
+
+wait "$clone_pid"
+
+mkdir -p "$OUT_DIR"
+
+node packages/cli/bin/cli.mjs generate \
+  -t orama-db \
+  -t legacy-json \
+  -t llms-txt \
+  -t html \
+  -i "./$SRC_DIR/doc/api/*.md" \
+  --ignore "./$SRC_DIR/doc/api/quic.md" \
+  -o "./$OUT_DIR" \
+  -c "./$SRC_DIR/CHANGELOG.md" \
+  -v "$LATEST_TAG" \
+  --type-map "./$SRC_DIR/doc/type-map.json" \
+  --index "./$SRC_DIR/doc/api/index.md" \
+  --config-file "./beta/doc-kit.config.mjs" \
+  --log-level debug
+
+cp "$SRC_DIR"/doc/api/*.md "$OUT_DIR/"

package.json

@@ -0,0 +1,21 @@
+{
+  "name": "doc-kit",
+  "compatibility_date": "2026-08-11",
+
+  "assets": {
+    "directory": "../../../out",
+    "html_handling": "auto-trailing-slash",
+    "not_found_handling": "404-page",
+  },
+
+  "routes": [
+    {
+      "pattern": "beta.docs.nodejs.org",
+      "custom_domain": true,
+    },
+  ],
+
+  "observability": {
+    "enabled": true,
+  },
+}

scripts/deployments/beta/main.sh

@@ -0,0 +1,22 @@
+{
+  "name": "doc-kit",
+  "account_id": "07be8d2fbc940503ca1be344714cb0d1",
+  "compatibility_date": "2026-08-11",
+
+  "assets": {
+    "directory": "../../../www/out",
+    "html_handling": "auto-trailing-slash",
+    "not_found_handling": "404-page",
+  },
+
+  "routes": [
+    {
+      "pattern": "doc-kit.nodejs.org",
+      "custom_domain": true,
+    },
+  ],
+
+  "observability": {
+    "enabled": true,
+  },
+}