Display
One repository's display: the builds its display.json (on the default branch) shows. Read only.
- Page:
/<owner>/<repo>/display. Server-rendered. The title and layout, then one row per build: name, version, and, when you may read the build's repository, links to its screenshots and the repository. A build whose repository you cannot read shows its name and version and "Private", nothing more. Adisplay.jsonthat does not parse shows its error. - 404: a repository with no
display.json, one that does not exist, and one you may not read all answer the same 404. - Reaching it: each row of
/displayslinks to it. - Terminal: in a repository's screen, the palette command "<owner>/<repo> — Display" (
src/tui/screens/display.ts) shows the same title, layout and builds with the same open/private split, from the samedisplayOfanddisplayItems.j/kmove,escgoes back. A repository you may not read is not offered it, and the screen itself says "No display here".
- Choosing builds: a person who writes the repository (never an agent) ticks builds and saves, on the page, in the terminal, or over the API. The page form posts to the same page (works without script; with script it sends the PUT); the terminal's Display screen shows
[x]/[ ]rows for a writer,spaceticks andssaves; the API isPUT /api/v1/repos/:owner/:name/display/buildswith{ "builds": ["owner/name:label", …], "tip"?: commit }(rw scope, same-origin for a session). All three callchooseBuilds(src/actions/displays.ts), which commitsbuildsintodisplay.json. Each build must be a pin in a repository the writer reads (422 otherwise); atipthat is no longer the default branch's commit is a 409. Order is the order shown; reordering waits.
- Launch: the Arcade's display (the
arcade-buildsshelf) offers Launch, which opens the Arcade host atarcade.<app domain>: its carts as a carousel, playable by keyboard (◀ ▶, Z X, Enter) or by tap, with prev/next buttons, and an offline snapshot to download. On the page it is the "Launch" button beside the title; in the terminal the Display screen's first line ends "Launch: <url>/" (fromlaunchUrl,src/arcade/host.ts). The host answers reads only, with the security floor and a policy that allows no third-party origin; carts play in sandboxed frames. Nothing is offered where apps do not run.
Not done: editing the title and covers. See docs/features/displays.md for the list.