feat: fix buiild

README.md

@@ -61,11 +61,37 @@ python -m uframe deploy page.uf              # compile + copy to NomadNet pages
 ### Docker
 
 ```bash
-cd frontend && npm install && npm run build && cd ..
-docker compose up --build
+# 1. Build the frontend
+cd frontend
+npm install
+npm run build
+cd ..
+
+# 2. Build and start all services
+docker compose up --build -d
 ```
 
-App at http://localhost:8080. Add Tailscale: `tailscale serve --bg https+insecure://localhost:8080`
+This starts two containers:
+
+- **micronomicon** — the web IDE + API on <http://localhost:8080>
+- **nomadnet** — NomadNet node serving your published `.mu` pages
+
+Pages published through the IDE are written to a shared volume that NomadNet reads from. The Docker socket is mounted read-only so the IDE can restart NomadNet when needed.
+
+To follow logs: `docker compose logs -f`
+
+To stop: `docker compose down`
+
+To expose over Tailscale: `tailscale serve --bg https+insecure://localhost:8080`
+
+#### Deploy a page via CLI (into the running stack)
+
+```bash
+cd backend && source .venv/bin/activate
+python -m uframe deploy page.uf --dest "$(docker volume inspect micronomicon_pages -f '{{.Mountpoint}}')"
+```
+
+Or use the web IDE at <http://localhost:8080> and click **Publish**.
 
 ---
 
@@ -187,7 +213,7 @@ banner "My Node" "Mesh Network"              # use library component
 
 ```bash
 cd backend && source .venv/bin/activate
-python -m pytest uframe/tests/ -v    # 42 tests
+python -m pytest uframe/tests/ -v    # 91 tests
 ```
 
 ---