archy/demo-deploy/README.md
archipelago 2715f2d847 feat(demo): public multi-visitor demo sandbox for Portainer
Turn the mock backend + UI into a public, click-to-play demo deployable as a
Portainer stack, gated behind DEMO=1 (classic single-user mock unchanged when off).

Backend (neode-ui/mock-backend.js):
- Per-session state isolation via AsyncLocalStorage + Proxy: every visitor gets
  an isolated, deep-cloned copy of mockData/walletState/userState/etc., keyed by
  a demo_sid cookie. Per-session WebSocket fan-out, idle reaper, session cap.
- Real per-session file storage (upload/folder/rename/delete) with a 50MB quota,
  replacing the no-op filebrowser handlers; adds the missing app.filebrowser-token RPC.
- Force simulation mode (never touch a host Docker/Podman socket).
- Testnet (signet) flavor; shared login password "entertoexit".
- Report the real app version suffixed with -demo.

Frontend:
- VITE_DEMO build flag (useDemoIntro.ts): replay the intro once per calendar day
  per browser; prefill + show the "entertoexit" login hint.

Deploy:
- docker-compose.demo.yml wired for DEMO, UI on :2100 (build-from-repo).
- demo-deploy/ thin stack (prebuilt :demo image refs + .env.example + README).
- .github/workflows/demo-images.yml builds/pushes archy-demo-{web,backend} images.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-22 09:28:05 -04:00

1.6 KiB

Archipelago — Public Demo deploy

A click-to-play demo of the Archipelago UI, backed entirely by a mock backend. Every visitor gets an isolated, ephemeral sandbox (own apps, wallet, files), real container runtimes are never touched, and Bitcoin runs on signet test coins. Login password: entertoexit (shown on the login screen).

This directory is the full contents of the public archy-demo repo. It holds no source — only this compose file that pulls prebuilt :demo images.

Deploy in Portainer

  1. Stacks → Add stack → Repository (or paste docker-compose.yml into the web editor).
  2. Set environment variables (see .env.example) — at minimum REGISTRY, and ANTHROPIC_API_KEY if you want the AI chat panel.
  3. Deploy. The UI is served on :2100 (override with DEMO_WEB_PORT).

To pick up a new build, redeploy the stack (or wire the CI Portainer webhook).

How it stays current

The images are built from the Archipelago monorepo by .github/workflows/demo-images.yml on every change to neode-ui/, tagged :demo and :<git-sha>, and pushed to REGISTRY. Editing the real UI → CI rebuilds → redeploy here. No source lives in this repo.

What's mocked

  • Per-visitor isolation — state keyed by a demo_sid cookie, idle-reaped.
  • Apps — install/uninstall/start/stop are simulated (no real Docker).
  • Wallet/Bitcoin — signet-flavored; use the in-UI faucet for test sats.
  • Files — real per-session upload/rename/delete, 50 MB quota, wiped on reap.
  • Intro — replays once per calendar day per browser.