Introduction

This site is the operating manual for the today-platform-web monorepo. It documents how the repo runs, not what the products do.

It is written for two readers in parallel:

• New contributors picking up the repo for the first time — start with Repo tour, then follow the new-contributor path in Reading paths.
• AI agents working in this repo through Claude Code, Cursor, or the SDK — fetch /llms.txt for the index, /llms-full.txt for everything concatenated, or /docs/<path> with Accept: text/markdown for a single page.

What this site owns

The chapters marked (PR-CB) and (PR-CC) ship in follow-up PRs. PR-CA1 lands the scaffold, the Orientation section, and the Workspace section — enough to navigate the repo on day one.

What this site does not own

This is one of three Fumadocs sites in the monorepo. The boundary is documented in Workspace → Docs sites. In short:

• Need to know the WebView Bridge wire contract or write a native host? → apps/webview-bridge-docs (deployed separately).
• Need to use a TDX component, design token, or Opal primitive? → design-system/docs (deployed separately).
• Need to understand how a specific app's internals work (chat runtime, embedded canvas, etc.)? → apps/<app>/docs/ next to the code.

If a doc fits more than one site, it usually belongs in the one closest to the code it describes. This site only owns repo-wide, cross-package material.

Agent-friendly routes

/llms.txt              — site index (recommended starting point for agents)
/llms-full.txt         — every page concatenated as one markdown blob
/docs/<path>.md        — single page as raw markdown
/docs/<path>           — single page as raw markdown if Accept: text/markdown

The per-page markdown routes are powered by Fumadocs' negotiation proxy (proxy.ts) plus /llms.mdx/docs/[[...slug]].