diff --git a/README.md b/README.md index 0629878..3f07c52 100644 --- a/README.md +++ b/README.md @@ -50,8 +50,7 @@ What is in each one, and what a re-run would change: reseeds on `Reset`), so a re-run gets a different field. The HUD, the border, the controls hint and the high score are the arcade's own. - **`index-screen.html`** — the arcade's index. Whatever is in the machine's - recently-played list is what lands on the page, Brickough included; see the - note on the registry below. + recently-played list is what lands on the page, Brickough included. - **`pixels-*.html`** — the same ship in the same cells, four times. Asteroid starts a wave with the ship dead centre, so these four are reproducible and differ in nothing but how a cell is subdivided. They are set @@ -62,11 +61,9 @@ What is in each one, and what a re-run would change: Nothing is invented. The claims worth re-checking when the arcade changes: -- **The three games and their descriptions** are the arcade's own README. - Asteroid and Tetris are the starter pack, committed as `.tcade` packages and - embedded in the binary; Brickough is not in that repository at all, which is - why the page tags it differently rather than listing three games as though - they arrived the same way. +- **The three games and their descriptions** are the arcade's own README. All + three are starter-pack `.tcade` packages committed in the arcade repository + and embedded in the binary. - **The pixel table** — the values, the grids and the font requirements are `TERMCADE_PIXELS`', including that `quad` is the default and that `sextant` needs Unicode 13 or renders as tofu. @@ -84,12 +81,9 @@ Nothing is invented. The claims worth re-checking when the arcade changes: protocol's event-type reporting where the terminal answers, and the auto-repeat fallback in `sdk.KeyTracker` everywhere else. -**The registry is not live, and the page says so.** `registry.DefaultURL` is -`http://127.0.0.1:8080` until termcade.com is serving, so `termcade add` talks -to a local development registry and not to anything a visitor has. The -marketplace section states that in its own paragraph rather than letting the -command table imply otherwise, and the arcade in `index-screen.html` has -Brickough installed from exactly such a registry. +**The registry is live.** Released clients use `https://api.termca.de`. +`TERMCADE_REGISTRY` selects a different registry for development; the public +site describes the production path. ## Colour diff --git a/src/pages/index.astro b/src/pages/index.astro index 0298d1e..7315199 100644 --- a/src/pages/index.astro +++ b/src/pages/index.astro @@ -25,9 +25,9 @@ const docs = 'https://github.com/aviorstudio/termcade/blob/main/docs'; const icon = (name: keyof typeof octicons, size = 16) => octicons[name].toSVG({ width: size, height: size }); -// Every game the arcade can put in front of you, and where it comes from. Two -// are in the binary; the third is not, and says so — it is the one that proves -// the packaging path, so hiding the difference would hide the point. +// Every game in the starter pack. They are packages embedded in the binary, +// not game code compiled into the host, and run through the same wasm boundary +// as anything added from the marketplace. const games = [ { name: 'ASTEROID', @@ -43,9 +43,9 @@ const games = [ }, { name: 'BRICKOUGH', - from: 'Marketplace', + from: 'Bundled', blurb: - 'Breakout-style brick breaker: steer the ball with paddle english, clear the wall, survive the speed-up. It lives outside the arcade repository, the way a third-party game does.', + 'Breakout-style brick breaker: steer the ball with paddle english, clear the wall, survive the speed-up.', }, ]; @@ -82,12 +82,13 @@ const pixelStyles = [ const commands = [ { cmd: 'termcade', what: 'play — the marketplace is in here too, on m' }, - { cmd: 'termcade add author/slug', what: 'add a game from the marketplace, a .tcade file, or a URL' }, + { cmd: 'termcade add author/slug', what: 'add a marketplace game to your account and this machine' }, { cmd: 'termcade list', what: 'what is in your arcade' }, { cmd: 'termcade remove author/slug', what: 'take one off, and off your synced library' }, { cmd: 'termcade signup', what: 'create an account — or termcade login, termcade logout' }, { cmd: 'termcade dev new you/mygame', what: 'scaffold a game that is already playable' }, { cmd: 'termcade dev build', what: 'package a game directory into a .tcade' }, + { cmd: 'termcade dev install build/game.tcade', what: 'install a local package while developing' }, ]; // What a game author is committing to. All of it is in sdk/game.go and @@ -148,7 +149,7 @@ const contract = [

In the arcade

-

Two games in the box, and the way in for the rest.

+

Three games in the box, and the way in for the rest.

The starter pack is committed as packages and embedded in the binary, then unpacked into your games directory the first time it runs. The games that come with the arcade @@ -246,17 +247,16 @@ const contract = [

The front door

Opens on what you played last.

- The library is one keystroke away and the marketplace one more. Browsing and - installing the demo packages needs no account; signing in is for having your library - follow you between machines, and the arcade has its own sign-in screens, so you never - have to come back to a website to do it. + The library is one keystroke away and the marketplace one more. Browsing is + open; signing in adds a game to the account library and installs it on this machine. + The library follows you to the web app and every terminal where you sign in, and the + arcade has its own account screens.

- The registry is not serving from termcade.com yet. Until it is, the arcade points at a - local development registry, and TERMCADE_REGISTRY moves it — the arcade - in the frame here has Brickough installed from one. Downloads are checked against the - registry's sha256 before anything lands on disk. Everything else on this page works - offline, today. + The live registry is api.termca.de. Package bytes pass through it and are + checked against the sha256 recorded when the release was published before either the + terminal or web app runs them. TERMCADE_REGISTRY selects a local registry + for development.

@@ -284,7 +284,7 @@ const contract = [

termcade dev new you/mygame scaffolds a game that already runs, termcade dev build turns the directory into a .tcade, and - termcade add puts it on your own menu. A game is a Go package implementing + termcade dev install puts the local build on your own menu. A game is a Go package implementing one interface — and because the boundary is a frozen wasm ABI rather than a Go one, Go is a convenience and not a requirement.

@@ -307,7 +307,7 @@ const contract = [
-

Two games in the box.
The rest is yours to write.

+

Three games in the box.
The rest is yours to write.

ONE BINARYSANDBOXED GUESTS60 TICKS A SECOND
Get termcade