Repository navigation
docs: fix tRPC/Hono comparison claims and old URL redirects - #2322
Conversation
…on guide - tRPC ships retryLink in @trpc/client 11.19, so "Built-in plugins (CORS, CSRF, Retry)" is partial, not unsupported. - Hono's OpenAPI and contract-first support come from middleware that hono.dev lists as third-party, the same source as its Standard Schema validator the page already rates partial. Mark both partial on the comparison page and the home page summary. - Name tRPC's official @trpc/openapi (alpha) in the OpenAPI prose, date the "one global error shape" claim, and stamp the versions checked. - Migration guide: tRPC's serializer is a configurable transformer (JSON by default), and fix two mangled Next.js route file titles. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01WwvdJXUJLcD4apwHfgDgkV
…osts OG images - 23 URLs that orpc.dev served in v1 return 404 today. Point the 17 with a v2 counterpart at it (mappings follow the v1 migration guide) and the v1-only pages (custom plugins, body parser, OpenAI streaming, Sentry, learn-and-contribute) at v1.orpc.dev, where they still live. - Restore /logo.webp and /og.jpg from the 1.x branch. The README on every npm `latest` (1.16.x) page embeds the logo, and the v1 site's og:image and twitter:image point at og.jpg, so both are broken today. - Blog posts render through a dynamic route, where PageLayout attaches no generated OG card, so shares had no image and the small Twitter card. Point them at the card Blume already renders for each post. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01WwvdJXUJLcD4apwHfgDgkV
ApprovabilityVerdict: Approved at Macroscope's review found this PR approvable — This is a low-risk content maintenance change: documentation claims and examples are corrected, homepage comparison labels are synchronized, two legacy documentation URLs redirect to current pages, and a static logo asset is restored. No application logic, API schema, security-sensitive code, or production infrastructure is changed. Notes:
You can add or adjust custom eligibility rules. Learn more. |
Deploying with
|
| Status | Name | Latest Commit | Preview URL | Updated (UTC) |
|---|---|---|---|---|
| ✅ Deployment successful! View logs |
orpc | 0cce3d1 | Commit Preview URL Branch Preview URL |
Oct 24 2026, 04:03 AM |
Codecov Report✅ All modified and coverable lines are covered by tests. 📢 Thoughts on this report? Let us know! |
More templates
@orpc/ai-sdk
@orpc/arktype
@orpc/bun
@orpc/client
@orpc/cloudflare
@orpc/contract
@orpc/experimental-effect
@orpc/evlog
@orpc/hibernation
@orpc/json-schema
@orpc/experimental-lock
@orpc/mcp
@orpc/msw
@orpc/nest
@orpc/next
@orpc/node
@orpc/openapi
@orpc/opentelemetry
@orpc/pinia-colada
@orpc/pino
@orpc/publisher
@orpc/ratelimit
@orpc/server
@orpc/shared
@orpc/swr
@orpc/tanstack-query
@orpc/trpc
@orpc/valibot
@orpc/zod
commit: |
Merging this PR will not alter performance1 warning
Comparing Footnotes
|
There was a problem hiding this comment.
✅ No new issues found.
Reviewed changes — reviewed the complete diff (7 files, 2 commits), checked against the repo, Blume internals, npm, and the 1.x branch.
- Comparison claims —
docs/comparison.mdxandpages/_home/Comparison.astro: tRPC built-in plugins 🛑→🟡 (retryLink), Hono contract-first and OpenAPI ✅→🟡, the tRPC error-shape claim dated to 11.19, and the OpenAPI prose rewritten around@trpc/openapi/@hono/zod-openapi, plus a "last checked" line. Both pages stay consistent. - tRPC migration guide — serializer row corrected to
transformer(e.g.superjson), and the two mangled Next.js route-file fence labels fixed totitle="...". - v1 redirects — 14 new rules in
blume.config.ts; every v2 target resolves to an existing page (and both#anchors hit real headings), and every v1frompath exists on1.x. - Restored assets —
public/logo.webpandpublic/og.jpg(1200×630), which fixes the v1 npm README logo and the v1 site's OG image served fromorpc.dev. - Blog OG cards —
pages/blog/[...slug].astronow passesogImage/ogImageAlt/ogImageSize;/og/<path>.pngmatches Blume's generated-card route, and the props matchPageLayout's contract.
deepseek-v4.1-flash (free via Pullfrog for OSS) | 𝕏
Drop redirects to v1.orpc.dev and to different features, so those URLs stay free for future pages. Keep the current OG image setup, and tighten the new comparison wording. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01WwvdJXUJLcD4apwHfgDgkV
Dismissing prior approval to re-evaluate 8ccf2cd
There was a problem hiding this comment.
ℹ️ No critical issues — one observation in the body.
Reviewed changes — delta from the prior pullfrog review (a1c4ab06 → 8ccf2cd): the redirect list was narrowed, the comparison prose tightened, the blog OG comment shortened, and og.jpg dropped.
- Redirects narrowed —
blume.config.tsnow keeps only the two same-feature moves (/docs/openapi/plugins/zod-smart-coercion→/docs/plugins/smart-coercion,/docs/integrations/tanstack-query-old/:slug*→/docs/integrations/tanstack-query); ten rules added by the previous commit (adapter aliases,superjson/strict-get-method, thev1.orpc.devfallbacks,durable-iterator) were dropped, returning those URLs to their pre-PR 404 state. Both retained sources exist on1.x, both targets exist onmain, and Blume 2.2.3 supports the:slug*pattern. - Comparison copy —
docs/comparison.mdx: OpenAPI paragraph rewritten around@trpc/openapi(alpha, tRPC-style endpoints) and@hono/zod-openapi; error-shape claim dated(as of 11.19); legend line shortened toChecked against tRPC 11.19 and Hono 4.13 (October 2026). - Blog OG comment —
pages/blog/[...slug].astro: the comment aboveogImagewas condensed; theogImage/ogImageAlt/ogImageSizeprops are unchanged. - Assets —
public/logo.webpkept (v1 READMEs embed it);public/og.jpgremoved.
ℹ️ Dropping og.jpg leaves the v1 docs' social image 404ing
The v1 docs still point their Open Graph and Twitter image metadata at https://orpc.dev/og.jpg, which is the v2 site's public/ directory. That URL currently returns 404, and 8ccf2cd removes the public/og.jpg that the preceding commit added to fix exactly this — so v1 doc link previews stay broken after this PR.
Technical details
# Restore `og.jpg` (or repoint the v1 config)
## Affected sites
- `apps/content/.vitepress/config.ts` (branch `1.x`) — `['meta', { property: 'og:image', content: 'https://orpc.dev/og.jpg' }]` and the matching `twitter:image` entry; both are absolute and resolve against the v2 domain this PR edits.
- `apps/content/public/og.jpg` — removed by `8ccf2cd`; absent from base `main`.
- `apps/content/blume.config.ts` — no `og.jpg` reference; the only `/og` output is Blume's per-route `/og/<route>.png` cards, so nothing serves `/og.jpg`.
## Required outcome
- `https://orpc.dev/og.jpg` resolves again, or the v1 metadata is changed to a URL that does (e.g. the v1 site's own domain or a generated card).
## Suggested approach (optional)
- Restore the 1200×630 `public/og.jpg` alongside `public/logo.webp`, matching the explicit reason `logo.webp` was kept (v1 `READMEs`/config embed assets on the `orpc.dev` origin). If the v1 config is changing instead, do it here so the two don't drift.
## Open questions for the human (optional)
- Was dropping `og.jpg` intentional because the v1 OG image is being retired/repointed elsewhere? If so, the v1 `.vitepress/config.ts` still needs the update.deepseek-v4.1-flash (free via Pullfrog for OSS) | 𝕏
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01WwvdJXUJLcD4apwHfgDgkV
Dismissing prior approval to re-evaluate 0cce3d1
There was a problem hiding this comment.
✅ No new issues found.
Reviewed changes — delta from the prior pullfrog review (8ccf2cd → 0cce3d1b): a single commit that reverts the blog post OG image props.
- Blog route reverted —
pages/blog/[...slug].astrodrops the explicitogImage/ogImageAlt/ogImageSizeprops, returning the dynamic route to its base state, so the PR no longer modifies the blog page at all. - Scope narrowed to match — the PR title and body were updated to drop the blog OG item, consistent with the revert.
Git confirms the delta is exactly 7 deletions in that one file; nothing else changed since the prior review.
deepseek-v4.1-flash (free via Pullfrog for OSS) | 𝕏

Requested by dinwwwh · project thread
retryLinkships in@trpc/client11.19). Hono contract-first and OpenAPI ✅ → 🟡 (third-party middleware per hono.dev), also on the home page. Mention@trpc/openapi(alpha) and date the error-shape claim.transformer, notsuperjson; fix two mangled route file titles.zod-smart-coercion,tanstack-query-old/*)./logo.webp: restored; npm READMEs embed it.pnpm docs:validatepasses; the production build andblume auditshowed 0 errors.🤖 Generated with Claude Code
https://claude.ai/code/session_01WwvdJXUJLcD4apwHfgDgkV