From cb48b21ac9cd3b9c7e7d5b83e76e10c62de008c1 Mon Sep 17 00:00:00 2001 From: Antoine BERNIER Date: Wed, 20 May 2026 11:21:31 +0200 Subject: [PATCH 1/7] Add MCP server install section on the home page Surfaces the docs.pmnd.rs MCP endpoint so devs can wire it into their AI coding assistant (Claude Code, Cursor, Windsurf, VS Code, etc.) with a single command. JSON snippet for non-CLI clients is tucked in a collapsible `
` to keep the section compact. --- src/app/page.tsx | 32 ++++++++++++++++++++++++++++++++ 1 file changed, 32 insertions(+) diff --git a/src/app/page.tsx b/src/app/page.tsx index 2faa1097..d99dbdb6 100644 --- a/src/app/page.tsx +++ b/src/app/page.tsx @@ -180,6 +180,38 @@ export default function Page() { .pmnd.rs +
+
+
+
+
MCP server
+
+ Browse these docs from your AI coding assistant — Claude Code, Cursor, Windsurf, + VS Code, and any MCP-compatible client. +
+
+ 
+                  {`claude mcp add --transport http pmndrs https://docs.pmnd.rs/api/mcp`}
+
+
+ + Other clients (JSON config) + + 
+                    {`{
+  "mcpServers": {
+    "pmndrs": {
+      "type": "http",
+      "url": "https://docs.pmnd.rs/api/mcp"
+    }
+  }
+}`}
+
+
+
+
+
+
{Object.entries(libs).map(([id, data]) => (
Date: Wed, 20 May 2026 11:33:23 +0200 Subject: [PATCH 2/7] Bump next-mdx-remote 5.0.0 -> 6.0.0 Next.js 16 build refuses to prerender with the vulnerable v5.0.0. compileMDX from /rsc keeps the same signature in v6 so no code change needed. Co-Authored-By: Claude Opus 4.7 (1M context) --- package.json | 2 +- pnpm-lock.yaml | 51 +++++++++++++++++++++++--------------------------- 2 files changed, 24 insertions(+), 29 deletions(-) diff --git a/package.json b/package.json index 9b45be6a..05bd24a6 100644 --- a/package.json +++ b/package.json @@ -70,7 +70,7 @@ "mcp-handler": "^1.0.7", "mermaid": "^11.12.2", "next": "^16.1.3", - "next-mdx-remote": "^5.0.0", + "next-mdx-remote": "^6.0.0", "next-themes": "^0.4.6", "react": "^19.0.0", "react-dom": "^19.0.0", diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml index 345e117d..d325e8ad 100644 --- a/pnpm-lock.yaml +++ b/pnpm-lock.yaml @@ -72,8 +72,8 @@ importers: specifier: ^16.1.3 version: 16.1.3(@babel/core@7.28.6)(@playwright/test@1.57.0)(react-dom@19.2.3(react@19.2.3))(react@19.2.3) next-mdx-remote: - specifier: ^5.0.0 - version: 5.0.0(@types/react@19.2.8)(react@19.2.3) + specifier: ^6.0.0 + version: 6.0.0(@types/react@19.2.8)(react@19.2.3) next-themes: specifier: ^0.4.6 version: 0.4.6(react-dom@19.2.3(react@19.2.3))(react@19.2.3) @@ -4920,8 +4920,8 @@ packages: neo-async@2.6.2: resolution: {integrity: sha512-Yd3UES5mWCSqR+qNT93S3UoYUkqAZ9lLg8a7g9rimsWmYGK8cVToA4/sF3RrshdyV3sAGMXVUmpMYOw+dLpOuw==} - next-mdx-remote@5.0.0: - resolution: {integrity: sha512-RNNbqRpK9/dcIFZs/esQhuLA8jANqlH694yqoDBK8hkVdJUndzzGmnPHa2nyi90N4Z9VmzuSWNRpr5ItT3M7xQ==} + next-mdx-remote@6.0.0: + resolution: {integrity: sha512-cJEpEZlgD6xGjB4jL8BnI8FaYdN9BzZM4NwadPe1YQr7pqoWjg9EBCMv3nXBkuHqMRfv2y33SzUsuyNh9LFAQQ==} engines: {node: '>=14', npm: '>=7'} peerDependencies: react: '>=16' @@ -6134,9 +6134,6 @@ packages: unist-util-filter@5.0.1: resolution: {integrity: sha512-pHx7D4Zt6+TsfwylH9+lYhBhzyhEnCXs/lbq/Hstxno5z4gVdyc2WEW0asfjGKPyG4pEKrnBv5hdkO6+aRnQJw==} - unist-util-is@5.2.1: - resolution: {integrity: sha512-u9njyyfEh43npf1M+yGKDGVPbY/JWEemg5nH05ncKPfi+kBbKBJoTdsogMu33uhytuLlv9y0O7GH7fEdwLdLQw==} - unist-util-is@6.0.1: resolution: {integrity: sha512-LsiILbtBETkDz8I9p1dQ0uyRUWuaQzd/cuEeS1hoRSyW5E5XGmTzlwY1OrNzzakGowI9Dr/I8HVaw4hTtnxy8g==} @@ -6146,21 +6143,21 @@ packages: unist-util-position@5.0.0: resolution: {integrity: sha512-fucsC7HjXvkB5R3kTCO7kUjRdrS0BJt3M/FPxmHMBOm8JQi2BsHAHFsy27E0EolP8rp0NzXsJ+jNPyDWvOJZPA==} - unist-util-remove@3.1.1: - resolution: {integrity: sha512-kfCqZK5YVY5yEa89tvpl7KnBBHu2c6CzMkqHUrlOqaRgGOMp0sMvwWOVrbAtj03KhovQB7i96Gda72v/EFE0vw==} + unist-util-remove@4.0.0: + resolution: {integrity: sha512-b4gokeGId57UVRX/eVKej5gXqGlc9+trkORhFJpu9raqZkZhU0zm8Doi05+HaiBsMEIJowL+2WtQ5ItjsngPXg==} unist-util-stringify-position@4.0.0: resolution: {integrity: sha512-0ASV06AAoKCDkS2+xw5RXJywruurpbC4JZSm7nr7MOt1ojAzvyyaO+UxZf18j8FCF6kmzCZKcAgN/yu2gm2XgQ==} - unist-util-visit-parents@5.1.3: - resolution: {integrity: sha512-x6+y8g7wWMyQhL1iZfhIPhDAs7Xwbn9nRosDXl7qoPTSCy0yNxnKc+hWokFifWQIDGi154rdUqKvbCa4+1kLhg==} - unist-util-visit-parents@6.0.2: resolution: {integrity: sha512-goh1s1TBrqSqukSc8wrjwWhL0hiJxgA8m4kFxGlQ+8FYQ3C/m11FcTs4YYem7V664AhHVvgoQLk890Ssdsr2IQ==} unist-util-visit@5.0.0: resolution: {integrity: sha512-MR04uvD+07cwl/yhVuVWAtw+3GOR/knlL55Nd/wAdblk27GCVt3lqpTivy/tkJcZoNPzTwS1Y+KMojlLDhoTzg==} + unist-util-visit@5.1.0: + resolution: {integrity: sha512-m+vIdyeCOpdr/QeQCu2EzxX/ohgS8KbnPDgFni4dQsfSCtpz8UqDyY5GjRru8PDKuYn7Fq19j1CQ+nJSsGKOzg==} + universal-user-agent@7.0.3: resolution: {integrity: sha512-TmnEAEAsBJVZM/AADELsK76llnwcf9vMKuPz8JflO1frO8Lchitr0fNaN9d+Ap0BjKtqWqd/J17qeDnXh8CL2A==} @@ -7480,7 +7477,7 @@ snapshots: unified: 11.0.5 unist-util-position-from-estree: 2.0.0 unist-util-stringify-position: 4.0.0 - unist-util-visit: 5.0.0 + unist-util-visit: 5.1.0 vfile: 6.0.3 transitivePeerDependencies: - supports-color @@ -11983,13 +11980,14 @@ snapshots: neo-async@2.6.2: {} - next-mdx-remote@5.0.0(@types/react@19.2.8)(react@19.2.3): + next-mdx-remote@6.0.0(@types/react@19.2.8)(react@19.2.3): dependencies: '@babel/code-frame': 7.28.6 '@mdx-js/mdx': 3.1.1 '@mdx-js/react': 3.1.1(@types/react@19.2.8)(react@19.2.3) react: 19.2.3 - unist-util-remove: 3.1.1 + unist-util-remove: 4.0.0 + unist-util-visit: 5.1.0 vfile: 6.0.3 vfile-matter: 5.0.1 transitivePeerDependencies: @@ -13353,10 +13351,6 @@ snapshots: unist-util-is: 6.0.1 unist-util-visit-parents: 6.0.2 - unist-util-is@5.2.1: - dependencies: - '@types/unist': 2.0.11 - unist-util-is@6.0.1: dependencies: '@types/unist': 3.0.3 @@ -13369,21 +13363,16 @@ snapshots: dependencies: '@types/unist': 3.0.3 - unist-util-remove@3.1.1: + unist-util-remove@4.0.0: dependencies: - '@types/unist': 2.0.11 - unist-util-is: 5.2.1 - unist-util-visit-parents: 5.1.3 + '@types/unist': 3.0.3 + unist-util-is: 6.0.1 + unist-util-visit-parents: 6.0.2 unist-util-stringify-position@4.0.0: dependencies: '@types/unist': 3.0.3 - unist-util-visit-parents@5.1.3: - dependencies: - '@types/unist': 2.0.11 - unist-util-is: 5.2.1 - unist-util-visit-parents@6.0.2: dependencies: '@types/unist': 3.0.3 @@ -13395,6 +13384,12 @@ snapshots: unist-util-is: 6.0.1 unist-util-visit-parents: 6.0.2 + unist-util-visit@5.1.0: + dependencies: + '@types/unist': 3.0.3 + unist-util-is: 6.0.1 + unist-util-visit-parents: 6.0.2 + universal-user-agent@7.0.3: {} universalify@0.1.2: {} From 79511af3561159ec39d71ba867a95ab40140041f Mon Sep 17 00:00:00 2001 From: Antoine BERNIER Date: Wed, 20 May 2026 12:22:52 +0200 Subject: [PATCH 3/7] Polish MCP server install section on home page Use the shared Gha (TIP alert) and Code components instead of ad-hoc markup. Primary install is now claude mcp add; JSON config moved behind a
. Link the "MCP-compatible client" wording to the MCP remote servers spec, and add a trailing note about per-lib llms.txt with the R3F example. Co-Authored-By: Claude Opus 4.7 (1M context) --- src/app/page.tsx | 73 +++++++++++++++++++++++++++++++++--------------- 1 file changed, 50 insertions(+), 23 deletions(-) diff --git a/src/app/page.tsx b/src/app/page.tsx index d99dbdb6..010101e1 100644 --- a/src/app/page.tsx +++ b/src/app/page.tsx @@ -7,6 +7,8 @@ import reactSpringIcon from '@/assets/react-spring-icon.svg' import uiKitIcon from '@/assets/uikit-icon.svg' import zustandIcon from '@/assets/zustand-icon.svg' import Icon from '@/components/Icon' +import { Code } from '@/components/mdx/Code/Code' +import { Gha } from '@/components/mdx/Gha/Gha' import { svg } from '@/utils/icon' import { Metadata } from 'next' import Image from 'next/image' @@ -181,35 +183,60 @@ export default function Page() {
-
-
-
-
MCP server
-
- Browse these docs from your AI coding assistant — Claude Code, Cursor, Windsurf, - VS Code, and any MCP-compatible client. -
-
- 
-                  {`claude mcp add --transport http pmndrs https://docs.pmnd.rs/api/mcp`}
-
-
- - Other clients (JSON config) - - 
-                    {`{
+            
+              

+                Browse these docs from your{' '}
+                
+                  MCP-compatible client
+                
+                , e.g. claude-code :
+              

+              
+                {`claude mcp add --transport http pmndrs https://docs.pmnd.rs/api/mcp`}
+              
+              

+                Other clients (JSON config)
+                
+                  {`{
   "mcpServers": {
     "pmndrs": {
       "type": "http",
       "url": "https://docs.pmnd.rs/api/mcp"
     }
   }
-}`}
-
-
-
-
+}`} + +
+

+ Each lib also exposes its{' '} + + + llms.txt + + {' '} + /{' '} + + + llms-full.txt + + {' '} +

+
From 2f357512cc318727d2a081810031d6a1a0f24cbc Mon Sep 17 00:00:00 2001 From: Antoine BERNIER Date: Wed, 20 May 2026 12:28:04 +0200 Subject: [PATCH 4/7] Add changeset for MCP server install section Covers the home-page changes and folds in the earlier MCP server URL fix (b06e545) that landed on main without a changeset. Co-Authored-By: Claude Opus 4.7 (1M context) --- .changeset/mcp-server-install-section.md | 5 +++++ 1 file changed, 5 insertions(+) create mode 100644 .changeset/mcp-server-install-section.md diff --git a/.changeset/mcp-server-install-section.md b/.changeset/mcp-server-install-section.md new file mode 100644 index 00000000..8a64f58d --- /dev/null +++ b/.changeset/mcp-server-install-section.md @@ -0,0 +1,5 @@ +--- +'@pmndrs/docs': patch +--- + +Add an MCP server install section on the home page (Claude Code shortcut + JSON config for other clients, link to the MCP remote-servers spec, mention of per-lib `llms.txt`). Also bundles the earlier MCP server URL / client configuration fix. From f7871574527f7cb3c899f408173af22d9fd854a3 Mon Sep 17 00:00:00 2001 From: Antoine BERNIER Date: Wed, 20 May 2026 12:32:17 +0200 Subject: [PATCH 5/7] Document changeset policy in README Spell out when a changeset is needed: not for the docs site itself (Vercel deploys on every main push), but for consumers using @v3 / Docker image tags who only pull versioned releases. Co-Authored-By: Claude Opus 4.7 (1M context) --- README.md | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/README.md b/README.md index f9574eb2..d0d6d85a 100644 --- a/README.md +++ b/README.md @@ -18,6 +18,26 @@ $ curl -sL https://raw.githubusercontent.com/pmndrs/docs/refs/heads/main/preview - you can pass any option from [configuration](docs/getting-started/introduction.mdx#Configuration) - in `DOCKER_IMAGE`, you can specify any `:tag` value from [docs packages](https://github.com/pmndrs/docs/pkgs/container/docs) container registry +# Releasing + +Every push to `main` auto-deploys [docs.pmnd.rs](https://docs.pmnd.rs) (Vercel). **No changeset needed** for the site to refresh. + +A changeset is needed when downstream consumers of this package should pull the change too — i.e. projects using: + +```yaml +uses: pmndrs/docs/.github/workflows/build.yml@v3 +# or +DOCKER_IMAGE: ghcr.io/pmndrs/docs:v3 +``` + +They follow the `@vX` major tag, which only moves when a new version is published. Adding a changeset triggers the release flow: version bump in `package.json`, `vX.Y.Z` + `vX` git tags, and a matching Docker image — so `@v3` resolves to the latest. + +```sh +$ pnpm changeset # creates .changeset/.md, pick `patch` / `minor` / `major` +``` + +TL;DR — add a changeset if your PR changes anything that consumers should see (templates, workflow, build behavior). Skip it for site-only tweaks. + # Test Visual tests are performed in the cloud, through [chromatic.yml](.github/workflows/chromatic.yml). From 1b4b2e5f50968074bc21b6d615b1df5b777dedef Mon Sep 17 00:00:00 2001 From: Antoine BERNIER Date: Wed, 20 May 2026 12:36:00 +0200 Subject: [PATCH 6/7] Tighten README changeset section + link relevant files Co-Authored-By: Claude Opus 4.7 (1M context) --- README.md | 18 +++--------------- 1 file changed, 3 insertions(+), 15 deletions(-) diff --git a/README.md b/README.md index d0d6d85a..93f00704 100644 --- a/README.md +++ b/README.md @@ -20,23 +20,11 @@ $ curl -sL https://raw.githubusercontent.com/pmndrs/docs/refs/heads/main/preview # Releasing -Every push to `main` auto-deploys [docs.pmnd.rs](https://docs.pmnd.rs) (Vercel). **No changeset needed** for the site to refresh. +Every push to `main` redeploys [docs.pmnd.rs](https://docs.pmnd.rs) via [ci.yml](.github/workflows/ci.yml) — no [changeset](.changeset/) needed for that. -A changeset is needed when downstream consumers of this package should pull the change too — i.e. projects using: +Add one (`pnpm changeset`) only when downstream consumers pinning `pmndrs/docs/.github/workflows/build.yml@v3` or `ghcr.io/pmndrs/docs:v3` should pull the change. It bumps [`package.json`](package.json), tags `vX.Y.Z` + `vX`, and publishes a matching Docker image — so `@v3` resolves to the latest. -```yaml -uses: pmndrs/docs/.github/workflows/build.yml@v3 -# or -DOCKER_IMAGE: ghcr.io/pmndrs/docs:v3 -``` - -They follow the `@vX` major tag, which only moves when a new version is published. Adding a changeset triggers the release flow: version bump in `package.json`, `vX.Y.Z` + `vX` git tags, and a matching Docker image — so `@v3` resolves to the latest. - -```sh -$ pnpm changeset # creates .changeset/.md, pick `patch` / `minor` / `major` -``` - -TL;DR — add a changeset if your PR changes anything that consumers should see (templates, workflow, build behavior). Skip it for site-only tweaks. +TL;DR — site-only tweak: skip. Anything consumers see (workflow, build behavior, templates): add one. # Test From 5a730d70602090f1167c9a48c538e25492a7081b Mon Sep 17 00:00:00 2001 From: Antoine BERNIER Date: Wed, 20 May 2026 12:38:45 +0200 Subject: [PATCH 7/7] Add `title` prop to to override the keyword-derived label Icon and background still follow the keyword. Document the new prop in docs/authoring/gha.mdx and use it on the home page MCP block. Co-Authored-By: Claude Opus 4.7 (1M context) --- docs/authoring/gha.mdx | 12 ++++++++++++ src/app/page.tsx | 2 +- src/components/mdx/Gha/Gha.tsx | 13 +++++++++++-- 3 files changed, 24 insertions(+), 3 deletions(-) diff --git a/docs/authoring/gha.mdx b/docs/authoring/gha.mdx index 3b7445c9..95754ce5 100644 --- a/docs/authoring/gha.mdx +++ b/docs/authoring/gha.mdx @@ -44,3 +44,15 @@ result: > [!CAUTION] > Negative potential consequences of an action. + +--- + +The `title` prop overrides the label derived from `keyword` (icon and background still follow the keyword). Only available via the JSX form: + +```md +Browse these docs from your MCP-compatible client. +``` + +result: + +Browse these docs from your MCP-compatible client. diff --git a/src/app/page.tsx b/src/app/page.tsx index 010101e1..92d964fe 100644 --- a/src/app/page.tsx +++ b/src/app/page.tsx @@ -183,7 +183,7 @@ export default function Page() {
- +