adds frontend

README.md

@@ -51,3 +51,23 @@ For visual debugging, expose VNC from the worker:
 ```
 
 The worker image starts Xvfb internally, so callers do not need to mount the host X11 socket or override the entrypoint.
+
+## Web UI
+
+The web path is split into three roles:
+
+- `src/frontend-server.mjs` serves the static UI and proxies `/api/*` and `/archives/*` to the backend.
+- `src/backend-server.mjs` manages archive lookup, job state, and the archive index.
+- `src/worker-server.mjs` runs inside the browser worker container and wraps `archivePage()` over HTTP.
+
+Run the full stack with:
+
+```sh
+docker compose -f docker-compose.example.yml up --build
+```
+
+Then open `http://localhost:5731`. Direct path archival is supported, for example:
+
+```text
+http://localhost:5731/https://example.com
+```