diff --git a/apps/wolf_3d_gui/README.md b/apps/wolf_3d_gui/README.md
index e969026..6532b29 100644
--- a/apps/wolf_3d_gui/README.md
+++ b/apps/wolf_3d_gui/README.md
@@ -75,6 +75,22 @@ Game data directory selection/persistence is managed by app managers and Flutter
 - **No game data discovered**: choose a valid directory in the picker and ensure files are present.
 - **Linux build/runtime issues**: verify native dependency packages are installed.
 - **Web target limitations**: use desktop target for full native-audio/path behavior.
+- **Web release build won’t load when opening `index.html` directly**: Flutter web output must be served over `http://` or `https://`, not opened with `file://`.
+
+ Build and serve locally:
+
+ ```bash
+ flutter build web --release
+ python3 -m http.server 8080 -d build/web
+ ```
+
+ Then open `http://localhost:8080` in your browser.
+
+ If deploying under a subpath, build with matching base href, for example:
+
+ ```bash
+ flutter build web --release --base-href /wolf_dart/
+ ```
 
 ## Related Modules