Redesign UI and add first-party Docker runtime support

README.md

@@ -48,6 +48,59 @@ Documentation for setup and configuration is [here](https://github.com/xteve-pro
 
 ---
 
+## Project Analysis (UI + Operations)
+
+The core architecture is strong: a Go backend with websocket-driven UI updates, filesystem-based state, and very low runtime overhead.
+The weakest points are mostly operational and UX-focused:
+
+* UI was historically utility-first and desktop-biased, with limited responsive behavior and visual hierarchy.
+* Container usage was documented externally but there was no first-party Dockerfile/compose setup in this repository.
+* Static web assets are generated into `src/webUI.go`, which works, but creates large diffs and a heavier edit/build cycle.
+
+### Recommended next technical improvements
+
+1. Replace generated `src/webUI.go` with Go `embed` for simpler static asset management and cleaner PR diffs.
+2. Add CI checks (`go test ./...`, build on Linux/arm64/amd64, docker build smoke test).
+3. Add a dedicated health endpoint (for example `/healthz`) to decouple health checks from HDHomeRun endpoints.
+4. Add integration tests around websocket commands that mutate settings/files to reduce regression risk.
+
+---
+
+## Container-First Run (Included In This Repo)
+
+### Build image
+```bash
+docker build -t xteve:local .
+```
+
+### Run with Docker Compose (bridge mode)
+```bash
+docker compose up -d
+```
+
+Compose file: `docker-compose.yml`  
+Persistent config volume: `./docker-data/config:/xteve/config`
+
+### Run with Docker Compose (host networking, Linux recommended for discovery)
+```bash
+docker compose -f docker-compose.host.yml up -d
+```
+
+Host networking improves LAN discovery behavior (SSDP/DLNA) for Plex/Emby in many setups.
+
+### Container environment variables
+
+* `XTEVE_CONFIG` (default: `/xteve/config`)
+* `XTEVE_PORT` (default: `34400`)
+
+### Image details
+
+* Multi-stage build (Go builder + minimal Alpine runtime)
+* Runs as non-root user (`xteve`)
+* Built-in healthcheck against `http://127.0.0.1:${XTEVE_PORT}/lineup_status.json`
+
+---
+
 ## Downloads v2 | 64 Bit only
 #### 64 Bit Intel / AMD
 
@@ -156,4 +209,3 @@ var GitHub = GitHubStruct{Branch: "master", User: "xteve-project", Repo: "xTeVe-
 
 ```
 
-