Say what tsbb is: a platform with front doors, not only a forum

[ralyodio]

tsbb.dev said "A TypeScript bulletin board" and stopped there. The API, the CLI, the MCP server, the installable app, the terminal client, runtime plugins and self-updating installs were either buried in the README or nowhere on the site at all.

What changed

The claims are data now. apps/server/src/platform.ts holds one list of front doors, each with a status. live means it is in this repository today; planned renders as a badge with no link. Four surfaces render that list instead of writing their own:

• the front page, in a panel below the board statistics (guests only)
• /about, with a new "What is it built on?" section
• /docs, at the top of the index
• /llms.txt, as a "What this board can do" section

Peer to peer is the only planned entry. There is no node-to-node code in the repository, so it is marked planned everywhere it appears and links nowhere. The README says the same thing in as many words.

New guides for the front doors that had none: docs/AGENTS.md, docs/PWA.md, docs/UPDATES.md, docs/SKINS.md. Served at /docs like the rest, so they are in llms-full.txt and the sitemap too.

README leads with the front-door table rather than the feature list.

Backed by code

Every claim was checked against this repository before it was written:

Claim	Where it lives
REST API + OpenAPI	apps/server/src/routes/api.ts, openapi.ts
CLI with --json	apps/cli/src/remote.ts
MCP over HTTP and stdio	apps/server/src/routes/mcp.ts, apps/mcp
Installable PWA	apps/server/src/routes/pwa.ts (manifest, worker, icons, /offline)
Machine files	apps/server/src/routes/discovery.ts
Plugins, no build step	packages/plugin-api, packages/plugin-host, plugins/
Self-updating	apps/server/src/updates.ts, packages/core/src/updates.ts
Three skins + tsbb-tui	packages/ui/src/styles, apps/tui
Feeds both ways	routes/discover.ts, packages/core/src/feed-sources.ts

Not backed by code, and not claimed as a feature: peer to peer / distributed boards. Nothing in the repository connects one board to another, federates, or syncs between nodes.

Also here

• board.showPlatform (Appearance, on by default) turns the front-page panel off for a board whose readers are not looking to run one of their own. Members never see it either way.
• llms.txt link labels come from each document's <h1> rather than the first clause of its blurb, which printed the whole sentence when a blurb had no colon.
• The docs page footer line used a style="…" attribute, which this board's CSP refuses, so it had been rendering unspaced. It is a class now.

Tests

pnpm test: 199 pass, 0 fail (193 before, 6 new). pnpm typecheck: clean. The formatter was not run, per the repo's state at HEAD.

test/platform.test.ts is the guard on the copy: every live claim must link at something answering 200, a planned one must have no link and must render as planned on /, /about and /docs, llms.txt must say the same thing the page does, and the grid must carry no inline style attribute.

🤖 Generated with Claude Code

https://claude.ai/code/session_01QuUkTrofSjQ15j79mRuy4f