From 183c4869e6baf03ad12d10ab8deeaec656a7d348 Mon Sep 17 00:00:00 2001
From: "Somhairle H. Marisol" <muqiu-han@outlook.com>
Date: Mon, 21 Sep 2026 02:26:27 +0800
Subject: docs(readme): require --noCache in the frontend fable command
 everywhere

---
 README.md | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 907fc50..89c962c 100644
--- a/README.md
+++ b/README.md
@@ -34,9 +34,15 @@ dotnet test SomhairlesDream.sln
 
 ```sh
 dotnet fable src/SomhairlesDream.Frontend/SomhairlesDream.Frontend.fsproj \
-  --outDir public --noRestore
+  --outDir public --noRestore --noCache
 ```
 
+`--noCache` avoids fable's shared project-options cache, which is keyed by
+fsproj content: reusing it across checkouts of the same project can yield
+spurious `Fable namespace not defined` errors (and even leave a corrupted
+`App.js` behind after a failed compile). The same flag is required in the
+clean-checkout sequence below.
+
 The server project copies `public/**` into its build output
 (`CopyToOutputDirectory=PreserveNewest`), so rerun `dotnet build` on the server
 after regenerating the bundle.
-- 
cgit v1.2.3