Rewrite the homepage for the person building a game

[seenu-k]

The homepage argued from the engine's point of view. Two of the three cards were the clearest symptom: "Bring your own game" named the whole product rather than one feature of it, and "One codebase runs many games" stated a property of the engine's source tree that changes nothing for the person reading it.

Homepage

The three cards now name what a project is actually handed — a server, an app, and the one part that is theirs — followed by a What you write / What you get split, which is the page's real argument: the second list is long, and none of it is their game. Tagline becomes Build games, not boilerplate, and the hero carries the two commands that start a project (scaffold, and the agent plugin).

Layout is Infima's throughout — hero hero--primary, row/col, card card--full-height, button--*, CodeBlock. An earlier pass in this branch had reimplemented .card (Infima ships card, card--full-height and card__body) and hand-coloured the hero buttons; both are gone, and local CSS is 72 lines that set no colour.

The single button is button--secondary deliberately. hero--primary fills the banner with --ifm-color-primary — the same variable button--primary paints itself with — so a primary button there is teal on teal and collapses to a floating label. There is a comment on the component saying so, because it looks like a downgrade and isn't.

How it works

It was not ready to be a landing target: it went from the design principle straight into a table of Cloudflare services. It now opens with the game model (state, action, observation, transition — and which of those are yours) and the server/client split, including the rules twin as a latency device rather than a second source of truth, before any infrastructure.

New page: Working with an agent

docs/build-a-game/with-an-agent.md covers the Claude Code skill, the llms.txt / .md / openapi.json retrieval surface, and the five mistakes agents specifically make on this contract — each of which produces code that survives a casual read. The skill was previously mentioned only in the engine repository's AGENTS.md, so it had no presence on the site at all.

Voice

Dropped engine-author phrasing found across the docs: "the crown jewel", "the platform serializes access to each game for us", "the one we read". Rewrote the scaffolder's "It does not negotiate versions while it runs" into what it means for the reader — you don't pick versions, you get a pair tested together — and moved it out of an admonition about network access.

Verification

lint, typecheck, check-admonitions, check-docs-version and build (which is also the link checker) all pass. The new page is in llms.txt and ships as both .html and .md.

One correction made while writing: a first draft claimed a reconnecting client "gets the current observation, not a backlog to replay." That is only true for a cold open — transport.md is explicit that a client which is behind fetches the missing span and animates through it. Fixed before landing.

🤖 Generated with Claude Code