fnLog0 · Oct 27, 2026 · Oct 27, 2026
diff --git a/packages/blocks/README.md b/packages/blocks/README.md
@@ -1,5 +1,9 @@
 # @locusgraph/blocks
 
+[![npm](https://img.shields.io/npm/v/@locusgraph/blocks?color=111111&style=flat-square)](https://www.npmjs.com/package/@locusgraph/blocks) [![MIT license](https://img.shields.io/badge/license-MIT-111111?style=flat-square)](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
@@ -1,5 +1,9 @@
 # @locusgraph/brand
 
+[![npm](https://img.shields.io/npm/v/@locusgraph/brand?color=111111&style=flat-square)](https://www.npmjs.com/package/@locusgraph/brand) [![MIT license](https://img.shields.io/badge/license-MIT-111111?style=flat-square)](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
@@ -1,8 +1,14 @@
 # @locusgraph/components
 
+<img alt="Locus Design: design that keeps humans in the loop" src="https://raw.githubusercontent.com/locusgraph/design/master/.github/assets/hero-light.png">
+
+[![npm](https://img.shields.io/npm/v/@locusgraph/components?color=111111&style=flat-square)](https://www.npmjs.com/package/@locusgraph/components) [![MIT license](https://img.shields.io/badge/license-MIT-111111?style=flat-square)](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
@@ -1,5 +1,9 @@
 # @locusgraph/config
 
+[![npm](https://img.shields.io/npm/v/@locusgraph/config?color=111111&style=flat-square)](https://www.npmjs.com/package/@locusgraph/config) [![MIT license](https://img.shields.io/badge/license-MIT-111111?style=flat-square)](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
@@ -1,5 +1,9 @@
 # @locusgraph/email
 
+[![npm](https://img.shields.io/npm/v/@locusgraph/email?color=111111&style=flat-square)](https://www.npmjs.com/package/@locusgraph/email) [![MIT license](https://img.shields.io/badge/license-MIT-111111?style=flat-square)](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
@@ -1,5 +1,9 @@
 # @locusgraph/json-render
 
+[![npm](https://img.shields.io/npm/v/@locusgraph/json-render?color=111111&style=flat-square)](https://www.npmjs.com/package/@locusgraph/json-render) [![MIT license](https://img.shields.io/badge/license-MIT-111111?style=flat-square)](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
@@ -1,5 +1,11 @@
 # @locusgraph/loop
 
+<img alt="Locus Design: design that keeps humans in the loop" src="https://raw.githubusercontent.com/locusgraph/design/master/.github/assets/hero-light.png">
+
+[![npm](https://img.shields.io/npm/v/@locusgraph/loop?color=111111&style=flat-square)](https://www.npmjs.com/package/@locusgraph/loop) [![MIT license](https://img.shields.io/badge/license-MIT-111111?style=flat-square)](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
@@ -1,5 +1,9 @@
 # @locusgraph/tokens
 
+[![npm](https://img.shields.io/npm/v/@locusgraph/tokens?color=111111&style=flat-square)](https://www.npmjs.com/package/@locusgraph/tokens) [![MIT license](https://img.shields.io/badge/license-MIT-111111?style=flat-square)](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
@@ -1,5 +1,9 @@
 # @locusgraph/utils
 
+[![npm](https://img.shields.io/npm/v/@locusgraph/utils?color=111111&style=flat-square)](https://www.npmjs.com/package/@locusgraph/utils) [![MIT license](https://img.shields.io/badge/license-MIT-111111?style=flat-square)](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