diff --git a/packages/blocks/README.md b/packages/blocks/README.md
index 9c4b6a64..ee55ed20 100644
--- a/packages/blocks/README.md
+++ b/packages/blocks/README.md
@@ -1,5 +1,9 @@
# @locusgraph/blocks
+[](https://www.npmjs.com/package/@locusgraph/blocks) [](https://github.com/locusgraph/design/blob/master/LICENSE)
+
+[Docs](https://design.locusgraph.com/blocks) · [Source](https://github.com/locusgraph/design/tree/master/packages/blocks) · [All packages](https://github.com/locusgraph/design#packages)
+
Product sections built from `@locusgraph/components` and its Rule Grid: the same usage, billing and API-key screens in every LocusGraph app. Blocks take plain data and callbacks; they never fetch.
```bash
diff --git a/packages/brand/README.md b/packages/brand/README.md
index aa82240a..787460e1 100644
--- a/packages/brand/README.md
+++ b/packages/brand/README.md
@@ -1,5 +1,9 @@
# @locusgraph/brand
+[](https://www.npmjs.com/package/@locusgraph/brand) [](https://github.com/locusgraph/design/blob/master/LICENSE)
+
+[Docs](https://design.locusgraph.com/brand) · [Source](https://github.com/locusgraph/design/tree/master/packages/brand) · [All packages](https://github.com/locusgraph/design#packages)
+
The LocusGraph mark and wordmark, and the Google and GitHub marks for sign-in buttons. React components, plus SVG files for favicons and anything that is not React.
```bash
diff --git a/packages/components/README.md b/packages/components/README.md
index 15cb56db..79623c73 100644
--- a/packages/components/README.md
+++ b/packages/components/README.md
@@ -1,8 +1,14 @@
# @locusgraph/components
+
+
+[](https://www.npmjs.com/package/@locusgraph/components) [](https://github.com/locusgraph/design/blob/master/LICENSE)
+
+[Docs](https://design.locusgraph.com/components) · [Source](https://github.com/locusgraph/design/tree/master/packages/components) · [All packages](https://github.com/locusgraph/design#packages)
+
The Locus Design system: React components on Radix, the App and Docs shells, and the theme
-(`theme.css`) every LocusGraph app uses. See every component with a live playground in
-`apps/design` (`pnpm --filter @locusgraph/design dev`, port 5180).
+(`theme.css`). See every component with a live playground at
+[design.locusgraph.com](https://design.locusgraph.com).
## Use it in an app
diff --git a/packages/config/README.md b/packages/config/README.md
index 062627ac..ee14f469 100644
--- a/packages/config/README.md
+++ b/packages/config/README.md
@@ -1,5 +1,9 @@
# @locusgraph/config
+[](https://www.npmjs.com/package/@locusgraph/config) [](https://github.com/locusgraph/design/blob/master/LICENSE)
+
+[Docs](https://design.locusgraph.com) · [Source](https://github.com/locusgraph/design/tree/master/packages/config) · [All packages](https://github.com/locusgraph/design#packages)
+
The Biome, TypeScript, Vitest, Cucumber, PostCSS and shadcn configuration LocusGraph projects share. It replaces `@spendgraph/config`; the theme and typography CSS moved to `@locusgraph/tokens`.
```bash
diff --git a/packages/email/README.md b/packages/email/README.md
index cdedbc91..1e080ddc 100644
--- a/packages/email/README.md
+++ b/packages/email/README.md
@@ -1,5 +1,9 @@
# @locusgraph/email
+[](https://www.npmjs.com/package/@locusgraph/email) [](https://github.com/locusgraph/design/blob/master/LICENSE)
+
+[Docs](https://design.locusgraph.com) · [Source](https://github.com/locusgraph/design/tree/master/packages/email) · [All packages](https://github.com/locusgraph/design#packages)
+
LocusGraph transactional emails as React templates. Square panel, hairline borders and a pill button, with colors from `@locusgraph/tokens`. Everything is inline-styled tables, so it renders in Gmail, Outlook and Apple Mail. No React Email dependency.
```bash
diff --git a/packages/json-render/README.md b/packages/json-render/README.md
index 1e16723d..0b05ceff 100644
--- a/packages/json-render/README.md
+++ b/packages/json-render/README.md
@@ -1,5 +1,9 @@
# @locusgraph/json-render
+[](https://www.npmjs.com/package/@locusgraph/json-render) [](https://github.com/locusgraph/design/blob/master/LICENSE)
+
+[Docs](https://design.locusgraph.com/generative-ui) · [Source](https://github.com/locusgraph/design/tree/master/packages/json-render) · [All packages](https://github.com/locusgraph/design#packages)
+
A [json-render](https://json-render.dev) catalog and registry for Locus Design components and blocks. A model lays out a Locus Design screen as JSON; json-render draws it with the real components, in the Locus Design look. Data comes from state through `$state` bindings, so the model picks the layout and never writes the numbers.
```bash
diff --git a/packages/loop/README.md b/packages/loop/README.md
index b7be0173..5c0cfa97 100644
--- a/packages/loop/README.md
+++ b/packages/loop/README.md
@@ -1,5 +1,11 @@
# @locusgraph/loop
+
+
+[](https://www.npmjs.com/package/@locusgraph/loop) [](https://github.com/locusgraph/design/blob/master/LICENSE)
+
+[Docs](https://design.locusgraph.com/human-in-the-loop) · [Source](https://github.com/locusgraph/design/tree/master/packages/loop) · [All packages](https://github.com/locusgraph/design#packages)
+
Loop is the agent kit from Locus Design: chat, what the agent is doing, human-in-the-loop approvals, memory and cost. Components take data and callbacks only and never call a model. Message shapes follow the Vercel AI SDK `UIMessage` parts, so `useChat()` output can be passed straight in.
```bash
diff --git a/packages/tokens/README.md b/packages/tokens/README.md
index 83f6e6fd..e509c2c6 100644
--- a/packages/tokens/README.md
+++ b/packages/tokens/README.md
@@ -1,5 +1,9 @@
# @locusgraph/tokens
+[](https://www.npmjs.com/package/@locusgraph/tokens) [](https://github.com/locusgraph/design/blob/master/LICENSE)
+
+[Docs](https://design.locusgraph.com/theming) · [Source](https://github.com/locusgraph/design/tree/master/packages/tokens) · [All packages](https://github.com/locusgraph/design#packages)
+
The LocusGraph theme for Tailwind CSS 4, and the same values as TypeScript for places CSS cannot reach, such as email.
```bash
diff --git a/packages/utils/README.md b/packages/utils/README.md
index cc520b73..d3b8265a 100644
--- a/packages/utils/README.md
+++ b/packages/utils/README.md
@@ -1,5 +1,9 @@
# @locusgraph/utils
+[](https://www.npmjs.com/package/@locusgraph/utils) [](https://github.com/locusgraph/design/blob/master/LICENSE)
+
+[Docs](https://design.locusgraph.com) · [Source](https://github.com/locusgraph/design/tree/master/packages/utils) · [All packages](https://github.com/locusgraph/design#packages)
+
Formatting and quota helpers the Locus Design packages share. No dependencies, no React.
```bash