oikos-web

The Oikos control-room client: the Svelte 5 SPA (web/), the Wails v3 desktop wrapper (desktop/), and the delivery stack that serves it (compose/, docker-compose.yml, scripts/deploy.sh).

Extracted from dtoro/oikos in Phase 1 of the hexagonal-architecture refactor (plans/2026-08-15-hexagonal-architecture.md in that repo). The backend (API, MCP, scheduler) stays in dtoro/oikos — this repo talks to it over REST/SSE only.

Layout

web/                Control-room SPA (Svelte 5, Vite)
desktop/            Wails v3 desktop wrapper (macOS + Linux)
compose/            Dockerfile + Caddyfile for the oikos-web image
cmd/webhook/        Deploy-webhook receiver (Gitea push → deploy)
scripts/deploy.sh   Deploy script (CI-green gate, versioned images)
docker-compose.yml  The single `web` service, publishing 8091:80

Dev

cd web && OIKOS_API_TOKEN=dev-token npm run dev   # proxies to api :8090/:8092
make desktop                                       # build the desktop app

The SPA's first-launch Config screen stores the server URL + token; the backend version is available via the API ping — the sidebar shows this repo's VERSION.

Versioning

Own VERSION file with the same rule as oikos: every commit to main bumps it (patch for fixes, minor for features). The version tag is shown in the SPA sidebar and stamped into desktop builds.

Deploy

Push to main → Gitea webhook → cmd/webhook receiver → scripts/deploy.sh: waits for CI green, builds oikos-web:v$VERSION from the working tree, docker compose up -d, prunes to the 3 newest tags. Rollback: OIKOS_VERSION=v0.x.y docker compose up -d.

Desktop auto-update reads this repo's Gitea releases. Builds installed before the extraction point at dtoro/oikos and need one manual reinstall (see the first release notes).