[dinwwwh]

Requested by dinwwwh · project thread

Two small SEO fixes that blume audit flags on a local build of apps/content.

Page titles

Three pages rendered a <title> longer than 60 columns, so search results cut off the end (including the "- oRPC" suffix). Each now has a shorter seo.title, and the on-page heading stays the same:

Page	New <title>
/blog/nextjs-ssr-orpc-tanstack-query	Next.js SSR with oRPC and TanStack Query - oRPC
/blog/uploads-bigger-than-your-ram	File Uploads Bigger Than Your RAM in JavaScript - oRPC
/docs/recipes/optimizing-ssr	Optimizing Server-Side Rendering (SSR) - oRPC

The custom blog page (pages/blog/[...slug].astro) built its title from title only, so it now reads seo.title first, as Blume's docs pages already do. The BlogPosting JSON-LD headline keeps the full title.

Links to sidebar-only pages

27 pages were reachable only from the sidebar, with no link from any page body. This links 15 of them where a reader would look for them:

• Getting Started → Create a Server: one sentence that names the framework adapters (Next.js, Nuxt, SvelteKit, Astro, TanStack Start, React Router, SolidStart, Hono, Express, Fastify, Elysia, H3).
• Message Port adapter: a short intro that points to the Electron, Web Workers, and Worker Threads guides.
• Context: a line after the auth example that points to the Better Auth integration.

Verification

• blume audit on a local build: the title warnings are gone and orphan pages drop from 27 to 12. The 12 left are mostly pages linked only from callouts, which the audit doesn't count, plus /docs/migrations/from-v1, which a separate version-clarity change covers.
• pnpm docs:validate passes with no broken links.

---

Generated by Claude Code

[macroscopeapp]

Approvability

Verdict: Approved at ae96af6

Macroscope's review found this PR approvable — This PR adds static documentation links, shortens selected page titles in generated metadata, and makes the blog template honor those optional titles while preserving the existing fallback. The changes are localized to documentation and prerendered page metadata with no broader runtime or API impact.

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

[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	ae96af6	Commit Preview URL Branch Preview URL	Oct 23 2026, 06:41 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@2316

@orpc/arktype

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

@orpc/bun

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

@orpc/client

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

@orpc/cloudflare

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

@orpc/contract

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

@orpc/experimental-effect

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

@orpc/evlog

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

@orpc/hibernation

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

@orpc/json-schema

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

@orpc/experimental-lock

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

@orpc/mcp

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

@orpc/msw

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

@orpc/nest

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

@orpc/next

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

@orpc/node

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

@orpc/openapi

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

@orpc/opentelemetry

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

@orpc/pinia-colada

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

@orpc/pino

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

@orpc/publisher

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

@orpc/ratelimit

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

@orpc/server

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

@orpc/shared

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

@orpc/swr

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

@orpc/tanstack-query

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

@orpc/trpc

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

@orpc/valibot

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

@orpc/zod

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

commit: ae96af6

[pullfrog]

✅ No new issues found.

Reviewed changes

• Shorter SEO titles — adds seo.title to nextjs-ssr-orpc-tanstack-query.mdx, uploads-bigger-than-your-ram.mdx, and recipes/optimizing-ssr.mdx so the rendered <title> stays within ~60 columns. The on-page title/H1 is deliberately left unchanged, matching the PR description.
• Custom blog page title precedence — pages/blog/[...slug].astro:110 now reads entry.data.seo?.title ?? entry.data.title, mirroring Blume's own docs-page behavior. JSON-LD headline still keeps the full title.
• Links to sidebar-only pages — adds 15 internal links: 12 framework adapters from getting-started.mdx, the message-port companion guides from adapters/message-port.mdx, and the Better Auth integration from context.mdx.

I verified seo is a valid, prefaulted frontmatter field in Blume's base page schema (so entry.data.seo?.title is well-typed and safe), that all 15 added link targets resolve to existing content files, and that the new frontmatter YAML is well-formed.

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

[dinwwwh]

test_matrix (26) is failing, but the cause isn't this PR. Every failing test is an Upstash-backed adapter test (packages/lock/src/adapters/upstash.test.ts and packages/ratelimit/src/adapters/upstash.test.ts), and each one fails with UpstashError: ERR max requests limit exceeded. Limit: 500000, Usage: 500000. The Upstash database CI uses has used up its request quota. This PR changes only docs content and the blog page template, so it doesn't touch any code those tests run. CI on main at the same base (3ff2342) passed at 06:24 UTC, before the quota ran out.

No in-repo fix exists. The quota on the Upstash account has to be raised, or it has to reset. I'll re-run the failed jobs once after this run finishes, but they will keep failing until the quota is available again.

---

Generated by Claude Code

[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-rxiu0u (ae96af6) with main (3ff2342)}

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. ↩