From b44160be931dafae953e9cec822840e16cb84a73 Mon Sep 17 00:00:00 2001
From: Yndira-E <yndira@flowfuse.com>
Date: Wed, 20 May 2026 15:23:03 +0200
Subject: [PATCH] Add warning note

---
 README.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/README.md b/README.md
index 1f3be0da80..890acb1579 100644
--- a/README.md
+++ b/README.md
@@ -67,6 +67,12 @@ This starts three watchers concurrently:
 
 **Note**: the first time running this, 11ty may take a little while to process all images in the `/docs` and `/handbook` folders.
 
+**Note**: if you have previously run `npm run build:nuxt`, clean the generated directories before starting dev or you will get a `spawn EBADF` error:
+
+```bash
+npm run clean:nuxt
+```
+
 ### Legacy-only mode
 
 To run just the legacy 11ty stack (equivalent to the old `npm start`):