Files
stemengine_old/QUICKSTART_LIVE_RELOAD.md

54 lines
1.3 KiB
Markdown

# WebUI Live Reload — Quick Start
**TL;DR**: Changes to frontend code now appear instantly in the browser. No rebuilds needed.
---
## Start Development Server
```bash
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:
```bash
# 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](20260317_WebUI_Live_Reload_Implementation.md) for full details.