Skip to content

docs(js): [Experiment] Server framework landing pages without a selector - #19973

Closed
JPeer264 wants to merge 4 commits into
masterfrom
jp/poc-selector-1-none
Closed

JPeer264 wants to merge 4 commits into
masterfrom
jp/poc-selector-1-none

Conversation

@JPeer264

@JPeer264 JPeer264 commented Oct 14, 2026 •

Copy link
Copy Markdown
Member

DESCRIBE YOUR PR

This turns the Express, Fastify, Hapi, Hono and Koa guides into single landing pages. The runtime SDKs instrument these frameworks automatically, so each page links to the Node.js, Bun and Deno quick starts (Hono also to Cloudflare). The old subpages redirect to the Node.js pages.

The runtime quick starts get no framework selector. Instead, a note at the top says that these frameworks need no extra setup, and links the frameworks that have their own SDK (Next.js, Nuxt, Elysia and others).

This also adds src/redirects.spec.ts. It fails when a redirect hides an existing page, for example a new page under guides/express/. It found 2 pages that nobody could open, which this PR removes.

Known issues

  • The Express-specific examples (app setup, /debug-sentry test route) are gone. The quick starts show the plain Node.js examples.
  • Cloudflare is linked only for Hono. Express, Koa and Hapi have no tested setup on Workers.
  • /platform-redirect/?platform=javascript.express shows the platform list instead of the Express page.
  • 43 framework includes are no longer used.

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 4 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>
…starts

The Node.js, Bun and Deno quick starts say that Express, Fastify, Hapi,
Hono and Koa need no extra setup, and link the frameworks that have
their own SDK (Next.js, Nuxt, SvelteKit, 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
sentry-docs Ready Ready Preview Oct 14, 2026 4:39pm UTC
1 Skipped Deployment
Project Deployment Actions Updated
develop-docs Ignored Ignored Oct 14, 2026 4:39pm 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

1 active deployment
Preview – sentry-docs — 6fc05ccf 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