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>
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
- Stacks → Add stack → Repository (or paste
docker-compose.ymlinto the web editor). - Set environment variables (see
.env.example) — at minimumREGISTRY, andANTHROPIC_API_KEYif you want the AI chat panel. - Deploy. The UI is served on
:2100(override withDEMO_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_sidcookie, 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.