54 lines
1.3 KiB
Markdown
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.
|