From f7157aa9c84c775b1418b4d5e386a320d4e12ec3 Mon Sep 17 00:00:00 2001
From: lizschwab <liz.schwab@raspberrypi.org>
Date: Wed, 19 Aug 2026 10:53:10 -0700
Subject: [PATCH 1/2] chore: added nx to docs start

---
 nx.json                    | 7 +++----
 packages/docs/package.json | 3 ++-
 2 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/nx.json b/nx.json
index 0756a8fc2ef..a85906fed71 100644
--- a/nx.json
+++ b/nx.json
@@ -26,10 +26,6 @@
       "outputs": ["{projectRoot}/dist"],
       "cache": true
     },
-    "docusaurus": {
-      "dependsOn": ["^docusaurus"],
-      "cache": true
-    },
     "docs": {
       "outputs": ["{projectRoot}/../docs/docs/reference"],
       "cache": true
@@ -111,6 +107,9 @@
     },
     "prepack": {
       "cache": true
+    },
+    "start": {
+      "continuous": true
     }
   },
   "neverConnectToCloud": true,
diff --git a/packages/docs/package.json b/packages/docs/package.json
index f81554bede9..e41584e242f 100644
--- a/packages/docs/package.json
+++ b/packages/docs/package.json
@@ -15,6 +15,7 @@
         ]
       },
       "build": {
+        "outputs": ["build", ".docusaurus", "node_modules/.cache"],
         "dependsOn": [
           {
             "projects": "blockly",
@@ -26,7 +27,7 @@
   },
   "scripts": {
     "docusaurus": "docusaurus",
-    "start": "docusaurus start",
+    "start": "npx nx run docusaurus start",
     "build": "docusaurus build",
     "swizzle": "docusaurus swizzle",
     "deploy": "docusaurus deploy",

From a22a295f60119f9eb9316acfad06bb663f97dc50 Mon Sep 17 00:00:00 2001
From: lizschwab <liz.schwab@raspberrypi.org>
Date: Wed, 19 Aug 2026 11:05:41 -0700
Subject: [PATCH 2/2] chore: fix output dir formatting

---
 packages/docs/package.json | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/packages/docs/package.json b/packages/docs/package.json
index e41584e242f..2b4489db499 100644
--- a/packages/docs/package.json
+++ b/packages/docs/package.json
@@ -15,7 +15,11 @@
         ]
       },
       "build": {
-        "outputs": ["build", ".docusaurus", "node_modules/.cache"],
+        "outputs": [
+          "{projectRoot}/build", 
+          "{projectRoot}/.docusaurus", 
+          "{projectRoot}/node_modules/.cache"
+        ],
         "dependsOn": [
           {
             "projects": "blockly",