---
title: "Vulpine in a browser"
description: "Vulpine in a browser, the web app: what it shows (a call frame, the transcript, the panel), how to build, install, serve and open it on the gateway host at 127.0.0.1:8794, and the showcase that needs no gateway."
type: "living"
source: "docs/web-app.md"
verified: "2026-11-14"
group: "Frontends"
---

> **Living doc**, checked against the code 2026-11-14

The web app is Vulpine in a browser tab: a full-screen call with portraits, a frame around them and a running
transcript. It talks to the same gateway as the desktop app, so a second screen can show the conversation while
you speak. Its look is called Vigil.

## What it shows

- **A call frame.** Five frames lay out the same conversation for a desk or a phone. The Look pane picks one, and
  `?frame=<id>` in the address picks one for a single visit. A phone in portrait gets the Transceiver frame by default.
- **The transcript,** written as the turn happens: your words, then the reply.
- **The panel,** when a reply shows a chart, a table or a card beside the speech.

## Open it

The web app is served by the gateway host on loopback, so open it in a browser on that Mac:

1. Build it: `just apps::vigil-build`.
2. Put the build in place: `just apps::vigil-install`.
3. Serve it: `just apps::vigil-serve-install`. It runs as a LaunchAgent on `127.0.0.1:8794` and restarts itself
   after a crash.
4. Open `http://127.0.0.1:8794/`. The page connects to the gateway on `ws://127.0.0.1:8780`.

Loopback counts as a secure origin, so the page may use the microphone and WebGPU. Nothing else on your network can
reach it.

## Try it without a gateway

`just apps::vigil-showcase` opens `/showcase.html`, which plays a scripted call through every frame. The installed
build serves the same page at `http://127.0.0.1:8794/showcase.html`.

To work on the app itself, `just apps::vigil-dev` runs it from the source with live reload.
