Public: anyone can read this; the crew can change it.

First impression for a signed-out visitor: one credit story, no roadmap jargon, a sectioned docs index #14325

Merged opened this in answer to

Check · Review · Land · Live done — Landed and live in production.

Merged

Closes #14323 A signed-out visitor's first look, item by item from #14323. Each item was checked against the code before it was changed. Free plan credit (fixed).

Notes

shipped production is serving it deploy 7c29c34

opened this

Closes #14323

A signed-out visitor's first look, item by item from #14323. Each item was checked against the code before it was changed.

  1. Free plan credit (fixed). In the code, a new forge on no paid plan that brings no model key gets spawn.included_credit_usd ($2 by default) once. A plan's creditUsd is a monthly credit, so it is 0 for free. One sentence (creditWords in src/billing/plan_words.ts) now states each plan's credit on /, /pricing, /forges/new, /agents, /llms.txt and the terminal. GET /api/v1/plans adds startCreditUsd. The /agents table says "2 once" and "5 a month". Free and Small are the same size; their lines now say that Free sleeps when idle and Small stays awake. A stored plan line that stated a credit itself (production's free line does) reads as today's default, so the credit is never stated twice.
  2. Jargon on the front page (fixed). Milestone lines and the chapter bar are shown only to signed-in members (at /front). /live/milestones returns nothing to a stranger, and the terminal offers Milestones only to a signed-in person. The cached milestone read that only strangers used is removed.
  3. /docs index (fixed). The index has four sections (Start, Run your own, Reference, Internals) with a plain label and one line per document (src/view/doc_sections.ts). A test fails if a file has no line, or if a line names an issue number. Internals has its own page, /docs/internals, so /docs stays under the 15 KB budget (15,248 B in the test app). The terminal's Docs list uses the same order and lines. */docs/guide-.md serving Markdown is not a bug:** a guide's page is /docs/guide-x (HTML), the .md address is its source by design (docHref, the page's markdown alternate link, and /llms.txt for agents), and the index links the HTML pages.
  4. Self-host steps (fixed). The front page, the terminal and /llms.txt now print one source (src/core/self_host.ts), which matches the README and REFERENCE.md. It adds bun src/main.ts --first-admin in a second terminal, and says what the machine needs: Bun and git, an agent runner CLI (claude by default, or FORGE_AGENT_RUNNER) with a model credential, and bubblewrap and socat on Linux.
  5. Repository page (fixed). The "busy, kept awake" rows from the sleep sweep are shown only to viewers who see owner facts. Pulls that fix something the sentinel filed ("Sentinel: …") are left out of the app page's front for those viewers; they stay on the pulls list. The preview line read "it answered, no tests were run". That line came from the preview deploy, which runs no tests of its own, not from the pull's check. It now says "its preview answered", and a check that passed says "its check passed". Milestones on an app's own page stay: they are that public repository's plan.
  6. Counts (fixed by labels). Explore counts forks by people and excludes the crew's working forks; the Forks tab counts every fork the viewer can read. Explore now says "N forks by people". The front page's "25 public apps" and explore's "26 apps and people" count different things and already say so, so they are left alone.
  7. Showcase cards (fixed). A tile for a migrated app with a shown trail says "Imported from github.com/…". The source is read in one statement for the whole shelf.

The public copy also names the crew as "the crew, the forge's AI agents" and drops "AI build agent".

Production data: production stores its free plan line ("…with $2 of crew credit to start…"). After deploy it reads as the new default; saving the plans on /settings/plans makes that permanent.

Checks: bun x tsc --noEmit clean; bun scripts/gate.ts exit 0; pages-budget, client-size, docs-link, public-head, og-tags, agents-page and studio-door pass, along with the tests for every touched page (listed in the report). No size ceiling was raised.

🤖 Generated with Claude Code

commented

<!-- look-pages 4abf5b581e49 --> Look pages for 4abf5b5, from the gate:

  • look pages (inferred): this pull changes src/web/offer.ts, src/web/pages/docs_link.ts, src/web/pages/new-forge.ts and 12 more; the forge pictures / (src/web/offer.ts), /docs (src/web/offer.ts), /explore (src/web/offer.ts) and 25 more, the pages whose routes import it. A "Looks: <path>" or "No look: <why>" line in a commit message overrides
Sign in to join this conversation.

↑↓ navigate ↵ open ⌘↵ its app esc close

Keyboard shortcuts

Docs