The browser client for the Selvage session protocol, over the engine and the bridge the editor clients share. A share link opens the page, a guest edits in Monaco and converges with the room, and the host's own client runs the relay, so this page joins the rooms an editor client or the MCP server hosts: a browser tab cannot open a listening socket. A guest edits in Monaco and converges with the room, and the folder itself is what the room shares, with the host's working copy staying the source of truth.
You need Node 22.18 or newer, and a running selvaged server the page can reach.
npm ci # install exactly what package-lock.json pins
npm run build # write dist/
npm run serve # serve dist/ at http://localhost:8081/Open http://localhost:8081/, paste an invite link, type a name and join. With no link the card
asks for one: a room is started in the host's own client, and this page cannot start one.
npm run serve is python3 -m http.server 8081 --directory dist. That port is the development
server's alone, chosen to avoid selvaged's default 8080; it is not the deployed page's port. The
image listens on 8080 and compose.yaml publishes it on 80 — see
Serving the page.
When you change a dependency, npm install --no-audit --no-fund writes the lockfile.
The checks a commit has to be green on run the same way: npm run typecheck reads the page's
TypeScript, and npm run test:ci is the suite CI gates on — node --test over the
test/*.test.ts files. The plain npm test hands node --test the directory instead, so run
test:ci when what you want is what CI runs.
The public contract workflow compares this candidate's
engine, bridge, CRDT pins, and release guard with their public canonical sources. It records the
exact Git revisions. The checker code is pinned independently of the canonical specification and
VS Code data, which follow public main and are resolved once per run. Its scheduled/manual
integration job builds a fresh public server, requires
the sibling site's mark comparison, and runs the live adapter and rendered-page proofs on loopback.
These are automated tests, not evidence of human acceptance. Reproduce the live proofs with:
SELVAGE_SELVAGED=/absolute/path/to/selvaged SELVAGE_CHROMIUM=/absolute/path/to/chromium \
scripts/ci-local.sh integrationRun npm ci and npm run build first. Evidence is written to .tmp/live-proofs/. Before a
repeat run, confirm the prior run has ended and rename that directory to a new, unused archive
name under .tmp/ (for example, live-proofs-20261101T120000Z). Retain the archive; do not delete
or overwrite earlier evidence. The harness refuses an existing evidence directory rather than
mixing runs. Missing tools, failed readiness, timeouts, and cleanup errors other than an already
removed browser profile fail the job. Catchable termination ends the owned process groups, records
the interruption with completed: false, and exits nonzero. Copy comparisons use the specification's public
workspace checker,
which also has an explicit-revision local invocation. Publish canonical updates before synchronized
consumers, following its
publication order;
a workflow file alone does not establish that the replacement public jobs ran.
There is no account: the name typed on the card is all the room knows a person by, and the page keeps it in the browser so the next card is prefilled. The file panel's width is remembered the same way. Nothing else is written down: a room's text lives in memory and ends when its host leaves.
- Where the server comes from: how the page reads its server from the link
- Serving the page: the one-origin shape, the page-only image, and the
relay
SELVAGE_SERVERgives it - Join a room: the page-link shape, the copy-invite commands, and the join card
- Hosting from the page: why the card offers no start action, and where the relay runs instead
- What the page does: the card, the session bar, follow, and the notices column
- Host-run relay: why a page joins a host-run relay, and how the host reaches guests over Tailscale
- Languages and peer markers: the mode list, and how a peer is drawn
MIT OR Apache-2.0, in LICENSE-MIT and LICENSE-APACHE.