mcc0x · Oct 16, 2026 · Oct 16, 2026 · Oct 16, 2026
diff --git a/README.md b/README.md
@@ -25,6 +25,13 @@ Pages use `title` and `order` front matter; `index.md` is a section's landing pa
 Use ordinary Markdown rather than executable MDX components. Repository housekeeping belongs
 outside `docs/` so it is not published as a product page.
 
+Screenshots live in `docs/images/` and are linked with relative Markdown image syntax, such as
+`![Alt text](../images/token-page.webp)`; raw HTML `<img>` tags are not resolved. Claire serves
+them from this public repository's `main` branch, so an image appears once its change is merged.
+Use PNG or WebP under 250 KB, crop to the relevant component, and write descriptive alt text.
+Public screenshots must not show test funds, local-fork labels, chain ids of test networks,
+test accounts or internal organization names.
+
 Changes go through a pull request with a passing **Docs check** before merging. A second
 person's approval is not required, so a solo maintainer can merge their own checked PR.
 CI has read-only repository permissions, uses pinned actions and a dependency lockfile,

diff --git a/docs/getting-started/index.md b/docs/getting-started/index.md
@@ -14,6 +14,8 @@ Your personal space and organization workspaces are separate. Personal navigatio
 
 Owners and admins can use the optional **Getting started** sidebar checklist. Hide or restore it for the selected organization in **Personal settings → Appearance**; the preference applies to your account in this browser.
 
+![The Finish setting up checklist on a workspace's Home page, grouped under Connect, Publish, Team and Optional, with a Connect Telegram shortcut.](../images/getting-started-checklist.webp)
+
 Claire uses a dark interface. Appearance offers preset or custom accent colours for this browser, not an account-wide theme or a change to your public site's appearance.
 
 ## Invite teammates

diff --git a/docs/images/change-the-split.webp b/docs/images/change-the-split.webp
diff --git a/docs/images/developer-create-key.webp b/docs/images/developer-create-key.webp
diff --git a/docs/images/getting-started-checklist.webp b/docs/images/getting-started-checklist.webp
diff --git a/docs/images/holder-rounds.webp b/docs/images/holder-rounds.webp
diff --git a/docs/images/launch-form-basics.webp b/docs/images/launch-form-basics.webp
diff --git a/docs/images/launch-form-buyback.webp b/docs/images/launch-form-buyback.webp
diff --git a/docs/images/launch-form-creator-share.webp b/docs/images/launch-form-creator-share.webp
diff --git a/docs/images/launch-form-economics.webp b/docs/images/launch-form-economics.webp
diff --git a/docs/images/launch-form-holder-share.webp b/docs/images/launch-form-holder-share.webp
diff --git a/docs/images/launch-preview.webp b/docs/images/launch-preview.webp
diff --git a/docs/images/new-lock-dialog.webp b/docs/images/new-lock-dialog.webp
diff --git a/docs/images/new-lock-revenue.webp b/docs/images/new-lock-revenue.webp
diff --git a/docs/images/proof-badge.webp b/docs/images/proof-badge.webp
diff --git a/docs/images/proof-locked-supply.webp b/docs/images/proof-locked-supply.webp
diff --git a/docs/images/proof-page.webp b/docs/images/proof-page.webp
diff --git a/docs/images/revenue-split.webp b/docs/images/revenue-split.webp
diff --git a/docs/images/token-page.webp b/docs/images/token-page.webp
diff --git a/docs/images/vesting-overview.webp b/docs/images/vesting-overview.webp
diff --git a/docs/reference/developer-api.md b/docs/reference/developer-api.md
@@ -16,7 +16,12 @@ Use Claire's read-only REST API from a server, CLI or agent to inspect a workspa
 2. Enable **API**, **MCP** or both, choose only the needed read scopes and select a 7-, 30- or 90-day expiry. Previously issued API keys remain API-only.
 3. Copy the secret when it appears; Claire retains a hash, not a recoverable copy. Revoke it when no longer needed. Changing its methods or scopes requires explicit manager approval and does not rotate the secret or expiry.
 
-A key stops working if its issuer loses owner or admin membership. Store it in your server environment or agent's secret store, never in browser code, a public variable, a skill file or source control. In **Knowledge**, the source must also be used (**Claire uses**) **and** explicitly approved (**Agents read**); approval defaults off. Existing keys receive no source data until an owner or admin approves the needed sources: lists may be empty and details may return 404. Neither a granted scope nor API/MCP method access alone exposes a source. See [Knowledge and Assets](../sources/context.md).
+![The Create key dialog: a name, an access method of API, MCP or Both, read permissions for organization context, Knowledge, asset metadata, Telegram, X mentions and token, and a 7-, 30- or 90-day expiry.](../images/developer-create-key.webp)
+
+> [!WARNING]
+> Store the key in your server environment or agent's secret store, never in browser code, a public variable, a skill file or source control. A key stops working if its issuer loses owner or admin membership.
+
+In **Knowledge**, the source must also be used (**Claire uses**) **and** explicitly approved (**Agents read**); approval defaults off. Existing keys receive no source data until an owner or admin approves the needed sources: lists may be empty and details may return 404. Neither a granted scope nor API/MCP method access alone exposes a source. See [Knowledge and Assets](../sources/context.md).
 
 | Scope | Read access when its sources are externally approved |
 | --- | --- |

diff --git a/docs/sources/token-actions.md b/docs/sources/token-actions.md
diff --git a/docs/sources/token.md b/docs/sources/token.md
@@ -16,6 +16,8 @@ There are [three ways in](token-actions.md#three-ways-in-on-robinhood-chain): la
 
 **Token** brings together the market (a price or holders chart, recent trades and top holders) and, beside it, the token itself, its market figures and its creator fees. **Creator fees**, **Vesting** and **Snapshots** are its sub-pages. Provider observations and the holder index have their own timestamps. A page load is not proof that upstream data was just collected.
 
+![A linked pons v2 token's overview card: contract addresses, bonding-curve progress, supply split into circulating, locked by pons and on the curve, and a notice that the creator share destination changes on a set date.](../images/token-page.webp)
+
 pons v2 uses a bonding curve in its chosen quote (native ETH or an approved pair token) before graduation.
 
 ## pons v2 stages and market data