Files
stemengine_old/QUICKSTART_LIVE_RELOAD.md
T

1.3 KiB

WebUI Live Reload — Quick Start

TL;DR: Changes to frontend code now appear instantly in the browser. No rebuilds needed.


Start Development Server

cd /home/translator/docker
docker compose up -d --build stemengine-webui

Then:

  • Open browser to http://localhost:5173
  • Edit any .tsx or .ts file in frontend/src/
  • Save and watch the browser update within 2-3 seconds

What's Different

Before After
Edit code Edit code
Run docker compose up -d --build stemengine-webui Save file
Wait 30-60 seconds Browser auto-reloads (2-3 sec)
Hard refresh browser See changes
See changes

If Something Breaks

Switch back to production build:

# Edit .env
# Change: WEBUI_DOCKERFILE=Dockerfile.webui.dev
# To:     WEBUI_DOCKERFILE=Dockerfile.webui

docker compose up -d --build stemengine-webui

Files Changed

  • ✅ frontend/Dockerfile.webui.dev — Dev-mode image
  • ✅ frontend/package.json — Added --host 0.0.0.0 to dev script
  • ✅ stemengine.yml — Added volume mount, switched to dev Dockerfile
  • ✅ .env — Set WEBUI_DOCKERFILE=Dockerfile.webui.dev (default)

See 20260317_WebUI_Live_Reload_Implementation.md for full details.