Skip to content

docs(js): [Experiment] Server framework landing pages with a "Server library" selector - #19975

Closed
JPeer264 wants to merge 5 commits into
masterfrom
jp/poc-selector-3-server-library
Closed

JPeer264 wants to merge 5 commits into
masterfrom
jp/poc-selector-3-server-library

Conversation

@JPeer264

@JPeer264 JPeer264 commented Oct 14, 2026 •

Copy link
Copy Markdown
Member

DESCRIBE YOUR PR

Same landing pages, redirect test and selector as #19974, with 2 differences:

  • The dropdown is named "Server library" and lists only Express, Fastify, Koa and Hapi.
  • A note below the dropdown links the frameworks that have their own SDK (Next.js, Nuxt, Elysia and others). The Cloudflare quick start has no dropdown and keeps its list of framework guides.

Known issues

  • "Server library" does not match how these projects describe themselves. Express, Fastify, Koa and Hono call themselves web frameworks, Hapi an "HTTP Server framework".
  • Hono is not in the dropdown. Its snippets still describe the sentry() middleware from @sentry/hono.
  • The table of contents does not show headings that only exist in a swapped-in snippet.
  • /platform-redirect/?platform=javascript.express shows the platform list instead of the Express page.

IS YOUR CHANGE URGENT?

Help us prioritize incoming PRs by letting us know when the change needs to go live.
Select exactly one option. For deadlines, replace YYYY-MM-DD with the due date. You can update this information later by editing the PR description.

  • Urgent deadline (GA date, etc.): YYYY-MM-DD
  • Other deadline: YYYY-MM-DD
  • No deadline: Not urgent, can wait up to 1 week+

SLA

  • Teamwork makes the dream work, so please add a reviewer to your PRs.
  • Please give the docs team up to 1 week to review your PR unless you've supplied a deadline.

Thanks in advance for your help!

PRE-MERGE CHECKLIST

Make sure you've checked the following before merging your changes:

  • Checked Vercel preview for correctness, including links
  • PR was reviewed and approved by any necessary SMEs (subject matter experts)
  • PR was reviewed and approved by a member of the Sentry docs team

JPeer264 and others added 5 commits October 13, 2026 09:49
Express, Fastify, Koa, Hapi and Hono no longer inherit the common
JavaScript pages. Each guide is now one landing page that links to the
runtime quick starts (Node.js, Bun, Deno, and Cloudflare for Hono),
because the runtime SDKs instrument these frameworks automatically.

Old subpages redirect to their Node.js equivalents. The Fastify
shouldHandleError docs moved to the Fastify integration page.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
/concepts/key-terms/tracing/event-detail/ (an empty file) and the draft
/platforms/javascript/legacy-sdk/integrations/ page are built, but the
redirects in middleware.ts send every visitor away from them.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Next.js checks redirects before it serves pages. A redirect source that
matches an existing page makes the page unreachable, for example a page
added under a guide that a catch-all rule sends to another guide.

The test matches every page path against the sources in redirects.js
with the same matcher as Next.js, and against middleware.ts.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…ick starts

Port of the framework selector from the fn/node-framework-selector
experiment. The Node.js, Bun and Deno quick starts get a dropdown that
swaps in the Express, Fastify, Koa or Hapi snippets, loaded on demand
from a static API route. The landing pages link to the quick starts
with the framework selected.

Cloudflare is left out, because these frameworks have no tested setup
on Workers.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The dropdown lists only Express, Fastify, Koa and Hapi, so its name is
now "Server library" instead of "Framework". A note below it links
the frameworks that have their own SDK (Next.js, Nuxt, Elysia and
others).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@vercel

vercel Bot commented Oct 14, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
develop-docs Ready Ready Preview Oct 14, 2026 4:31pm UTC
sentry-docs Ready Ready Preview Oct 14, 2026 4:31pm UTC

Request Review

@JPeer264

Copy link
Copy Markdown
Member Author

Closing in favor of #19974 (server frameworks) and #19977 (Next.js and Nuxt).

@JPeer264 JPeer264 closed this Oct 21, 2026

This branch was successfully deployed

2 active deployments
Preview – sentry-docs — cc7ab864 Deployed Oct 14, 2026 by vercel[bot]
Preview – develop-docs — cc7ab864 Deployed Oct 14, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Priority: Normal Docs review has no urgent deadline

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant