techbuzzz/delibera-webui repository overview

"# delibera-webui\n\nBrowser front end for Delibera — a Nuxt 4 application covering the debate workflow: list debates,\ncreate one from a registered template, watch rounds arrive live, read the verdict with token stats,\nexport Markdown, cancel a running debate.\n\nThis image is UI only. It talks to the API through\ndelibera-server⁠ and holds no state.\n\n---\n\n## Quick start\n\nbash\ndocker run -d --name delibera-webui \\\n -p 127.0.0.1:3000:3000 \\\n -e NUXT_DELIBERA_API_BASE=http://delibera-server:8080 \\\n techbuzzz/delibera-webui:latest\n\n\nThe API base URL has to be reachable from inside the container, so it is the service name on the\nDocker network — not localhost, and not a host-side address.\n\nOr bring up the full stack:\n\nbash\ncurl -O https://raw.githubusercontent.com/techbuzzz/Delibera/main/deploy/docker-compose.hub.yml\nexport DELIBERA_VERSION=10.5.3\ndocker compose -f docker-compose.hub.yml up -d\n\n\nThen open http://127.0.0.1:3000⁠.\n\n---\n\n## ⚠️ Security\n\nThis UI has no authentication of its own. It exposes everything the API exposes, including the\nability to spend LLM credits.\n\nEvery published port in the supplied compose file binds to 127.0.0.1 for that reason. Put an\nauthenticating reverse proxy in front before exposing this stack to any network you do not control.\n\n---\n\n## GitHub Pages\n\nThe project landing page lives at https://techbuzzz.github.io/Delibera/⁠. The Web UI itself is\nnot deployed there — it ships in this image and is meant to run next to\ndelibera-server⁠, which provides the\nsame-origin BFF route /api/delibera/**.\n\n---\n\n## How it reaches the API\n\nThrough a Nitro server-side proxy at /api/delibera/**, never directly from the browser. Two defects\nin the API force this:\n\n1. The server registers no CORS policy, so a browser calling the API origin directly is blocked on\n every request, GETs included.\n2. Absolute streamUrl / resultUrl values are built from Scheme://Host with no\n forwarded-header handling, so they point at the wrong host behind a proxy or an ingress.\n\nSSE is forwarded unbuffered, so a round appears the moment it is produced rather than at the end of\nthe debate.\n\n---\n\n## Configuration\n\n| Variable | Default | Meaning |\n| --- | --- | --- |\n| NUXT_DELIBERA_API_BASE | http://delibera-server:8080 | API base URL, resolved inside the container network |\n| NUXT_PUBLIC_TENANT_ID | default | Tenant forwarded to the API |\n| NODE_ENV | production | Standard Node environment |\n\n---\n\n## Architectures\n\nlinux/amd64 and linux/arm64, published together under one manifest per tag.\n\n## Tags\n\n- 10.5.3, 10.5 — pinned releases\n- latest — newest release\n\n## Links\n\n- Source: https://github.com/techbuzzz/Delibera\n-⁠ Release notes: https://github.com/techbuzzz/Delibera/releases\n\nMIT⁠ licensed."