docs

README.md

@@ -15,7 +15,7 @@ https://github.com/user-attachments/assets/62c52183-83a3-4fb5-97b1-ed001de4f53a
 - Ghostty WebAssembly terminal engine for fast rendering from [`ghostty-web`](https://github.com/rcarmo/ghostty-web)
 - Session dashboard with live PNG (or optional SVG) screenshots from [`go-te`](https://github.com/rcarmo/go-te)
 - Docker watch mode (`webterm-command` / `webterm-theme` labels)
-- Docker compose manifest ingestion
+- Docker compose manifest ingestion (see `prod.compose.yaml`)
 - CPU sparkline tiles for compose services
 - SSE activity updates for fast dashboard refresh
 - Mobile/touch support with virtual keyboard + draggable keybar
@@ -87,8 +87,10 @@ Available themes: `tango`, `xterm`, `monokai`, `monokai-pro`, `ristretto`, `dark
 
 ### Compose manifest
 
+Use `prod.compose.yaml` as the canonical multi-session compose example:
+
 ```bash
-go run ./cmd/webterm -- --compose-manifest ./docker-compose.yaml
+go run ./cmd/webterm -- --compose-manifest ./prod.compose.yaml
 ```
 
 ## Environment variables

docs/ARCHITECTURE.md

@@ -54,7 +54,7 @@ The server resolves static files from:
 
 ## Docker integration
 
-- **Compose mode** loads services from a compose manifest and creates tiles for services carrying `webterm-command`.
+- **Compose mode** loads services from a compose manifest (see `prod.compose.yaml`) and creates tiles for services carrying `webterm-command`.
 - **Watch mode** subscribes to Docker events and adds/removes tiles at runtime.
 - `webterm-theme` controls tile theme; default theme applies if unset. Available themes: `tango`, `xterm`, `monokai`, `monokai-pro`, `ristretto`, `dark`, `light`, `dracula`, `catppuccin`, `nord`, `gruvbox`, `solarized`, `tokyo`, `miasma`, `github`, `gotham`.