[dinwwwh]

Requested by dinwwwh · project thread

Adds a short index.mdx to each docs folder (Adapters, Plugins, Integrations, Helpers, OpenAPI, Contract, Client, RPC, Recipes, Migrations). Each page is a few lines of intro plus a grouped list linking every page in the section.

• /docs/plugins, /docs/openapi, etc. now resolve instead of 404.
• The sidebar group name opens its landing page. The index row is sidebar.hidden, so groups don't show a duplicate entry.
• Blume now emits BreadcrumbList JSON-LD on all 108 section pages (it dropped every trail before, since no group had a page).
• Orphan pages in blume audit drop from 27 to 1 (/experts, untouched).
• Getting Started and Contract-First "Next Steps" link the new pages.

Titles match the folder names; seo.title gives each a more descriptive <title>.

Checked locally: pnpm docs:validate passes, production build succeeds, blume audit reports 0 errors.

---

Generated by Claude Code

[macroscopeapp]

Approvability

Verdict: Approved at 8c909f8

Macroscope's review found this PR approvable — Adds section landing pages and related links to the documentation site, with no changes to production code, APIs, schemas, or deployment behavior. The runtime impact is limited to generated documentation pages and their navigation/SEO content.

^{You can add or adjust custom eligibility rules. Learn more.}

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

[cloudflare-workers-and-pages]

Deploying with    Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status	Name	Latest Commit	Preview URL	Updated (UTC)
✅ Deployment successful! View logs	orpc	8c909f8	Commit Preview URL Branch Preview URL	Oct 24 2026, 02:59 AM

[pkg-pr-new]

More templates

• @orpc/bun-playground
• @orpc/cloudflare-playground
• @orpc/nest-playground
• @orpc/next-playground

@orpc/ai-sdk

npm i https://pkg.pr.new/@orpc/ai-sdk@2325

@orpc/arktype

npm i https://pkg.pr.new/@orpc/arktype@2325

@orpc/bun

npm i https://pkg.pr.new/@orpc/bun@2325

@orpc/client

npm i https://pkg.pr.new/@orpc/client@2325

@orpc/cloudflare

npm i https://pkg.pr.new/@orpc/cloudflare@2325

@orpc/contract

npm i https://pkg.pr.new/@orpc/contract@2325

@orpc/experimental-effect

npm i https://pkg.pr.new/@orpc/experimental-effect@2325

@orpc/evlog

npm i https://pkg.pr.new/@orpc/evlog@2325

@orpc/hibernation

npm i https://pkg.pr.new/@orpc/hibernation@2325

@orpc/json-schema

npm i https://pkg.pr.new/@orpc/json-schema@2325

@orpc/experimental-lock

npm i https://pkg.pr.new/@orpc/experimental-lock@2325

@orpc/mcp

npm i https://pkg.pr.new/@orpc/mcp@2325

@orpc/msw

npm i https://pkg.pr.new/@orpc/msw@2325

@orpc/nest

npm i https://pkg.pr.new/@orpc/nest@2325

@orpc/next

npm i https://pkg.pr.new/@orpc/next@2325

@orpc/node

npm i https://pkg.pr.new/@orpc/node@2325

@orpc/openapi

npm i https://pkg.pr.new/@orpc/openapi@2325

@orpc/opentelemetry

npm i https://pkg.pr.new/@orpc/opentelemetry@2325

@orpc/pinia-colada

npm i https://pkg.pr.new/@orpc/pinia-colada@2325

@orpc/pino

npm i https://pkg.pr.new/@orpc/pino@2325

@orpc/publisher

npm i https://pkg.pr.new/@orpc/publisher@2325

@orpc/ratelimit

npm i https://pkg.pr.new/@orpc/ratelimit@2325

@orpc/server

npm i https://pkg.pr.new/@orpc/server@2325

@orpc/shared

npm i https://pkg.pr.new/@orpc/shared@2325

@orpc/swr

npm i https://pkg.pr.new/@orpc/swr@2325

@orpc/tanstack-query

npm i https://pkg.pr.new/@orpc/tanstack-query@2325

@orpc/trpc

npm i https://pkg.pr.new/@orpc/trpc@2325

@orpc/valibot

npm i https://pkg.pr.new/@orpc/valibot@2325

@orpc/zod

npm i https://pkg.pr.new/@orpc/zod@2325

commit: 8c909f8

[codspeed]

Merging this PR will not alter performance

1 warning

⚠️ 5 benchmarks are dominated by system calls

System calls cannot be simulated consistently and are left out of the measure. The reported value understates the real cost. Switch to the Walltime instrument to measure them.

Learn more about system calls

See affected benchmarks

✅ 28 untouched benchmarks
⏩ 2 skipped benchmarks¹

---

_{Comparing claude/project-thread-tvcu6d (8c909f8) with main (23fc494)}

Footnotes

1. 2 benchmarks were skipped, so the baseline results were used instead. If they were deleted from the codebase, click here and archive them to remove them from the performance reports. ↩

[pullfrog]

✅ No new issues found.

Reviewed changes

Docs-only. Adds a section landing page to each of the ten docs folders and wires up two cross-links.

• Ten new index.mdx landing pages — adapters, client, contract, helpers, integrations, migrations, openapi, plugins, recipes, rpc. Each has a short intro, a grouped list of every page in the section, a seo.title, and sidebar: { hidden: true } so the group row links the page without a duplicate sidebar row.
• Two "Next Steps" cross-links — getting-started.mdx and contract-first.mdx now point at the new /docs/helpers, /docs/recipes, /docs/migrations, and /docs/contract pages.

I verified the full diff against the tree: every link in all ten pages resolves to a real file, each index lists every page actually present in its folder, each hidden index title matches its folder's meta.ts title (or the humanized folder name for the meta-less folders), the (server)/(client)/(both) plugin role labels match the exported plugin classes, the adapter Fetch-API/Node-HTTP groupings match each page, and pnpm exec blume validate --strict exits 0 with no broken links. No concerns.

  ^{｜ View workflow run ｜ Using deepseek-v4.1-flash (free via Pullfrog for OSS) ｜ 𝕏}