From 3ea5c2788a03309f65399c57b719bd375f99d3ab Mon Sep 17 00:00:00 2001
From: Broque Thomas <26755000+Nezreka@users.noreply.github.com>
Date: Wed, 20 May 2026 09:22:08 -0700
Subject: [PATCH] Update README.md

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

diff --git a/README.md b/README.md
index 579dc488..eae068d0 100644
--- a/README.md
+++ b/README.md
@@ -279,10 +279,29 @@ The template points at `boulderbadgedad/soulsync:latest` (stable) by default. To
 git clone https://github.com/Nezreka/SoulSync
 cd SoulSync
 python -m pip install -r requirements.txt
+
+# Build the React WebUI bundle used by the Python server.
+# Docker does this automatically; Python installs must do it manually.
+cd webui
+npm ci
+npm run build
+cd ..
+
 gunicorn -c gunicorn.conf.py wsgi:application
 # Open http://localhost:8008
 ```
 
+When updating a Python/no-Docker install with `git pull`, rebuild the WebUI before restarting SoulSync:
+
+```bash
+cd webui
+npm ci
+npm run build
+cd ..
+```
+
+If `webui/static/dist/.vite/manifest.json` is missing or stale, React-owned routes and route handoffs may not load correctly.
+
 ### Local Development
 
 Use two terminals so the backend and Vite stay independent: