Skip to content

docs(js): Move the Cloudflare quick starts into the framework guides - #19977

Draft
JPeer264 wants to merge 10 commits into
masterfrom
jp/poc-c-runtime-quick-starts
Draft

docs(js): Move the Cloudflare quick starts into the framework guides#19977
JPeer264 wants to merge 10 commits into
masterfrom
jp/poc-c-runtime-quick-starts

Conversation

@JPeer264

@JPeer264 JPeer264 commented Oct 14, 2026 •
edited
Loading

Copy link
Copy Markdown
Member

DESCRIBE YOUR PR

This moves the pages under Cloudflare → Frameworks into their framework guides as "Quick Start (Cloudflare)", right below the default quick start, for example /guides/nextjs/cloudflare/. This applies to Astro, Hono, Next.js, Nuxt, Remix, SvelteKit and TanStack Start. All moved pages use the new quick start template, and the old URLs redirect.

  • Next.js on Cloudflare is now a full quick start (wizard, Wrangler configuration, withSentry Worker entry for OpenNext and vinext, verification).
  • The Hydrogen guides move into the React Router guide (Hydrogen 2025.5.0 and later) and the Remix guide (older versions, as "Hydrogen (Legacy)").
  • Cloudflare → Frameworks redirects to the Cloudflare quick start, which links to every framework page.
  • The TanStack Start page now installs @sentry/tanstackstart-react, which its code imports, and its Wrangler and source maps sections render again.

For humans there is also a runtime selector on each framework with support for other runtimes:

Image

For agents this will be added in #20367

Hono decision

The Hono quick start already covers Cloudflare in its runtime tabs, so "Quick Start (Cloudflare)" repeats those steps. The alternative is to redirect the old page to the Hono quick start. The runtime selector will be added in a follow up, as the Hono guide is already a bit different and needs some rework.

Verify decision

On the Astro, Remix, SvelteKit and TanStack Start pages, the test error comes from a button in the browser, as in the quick start template. A server test route would also show that the Worker setup works.

Known issues

  • No Bun or Deno quick starts for Next.js and Nuxt, because the SDK repo has no tests for them on these runtimes.
  • The Next.js verify step builds with opennextjs-cloudflare, so it does not apply to vinext apps.

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

@vercel

vercel Bot commented Oct 14, 2026 •
edited
Loading

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 31, 2026 9:27pm UTC
sentry-docs Ready Ready Preview Oct 31, 2026 9:27pm UTC

Request Review

@github-actions github-actions Bot added the Priority: Normal Docs review has no urgent deadline label Oct 14, 2026
This was referenced Oct 14, 2026
Closed
Draft
Closed
Closed
@JPeer264
JPeer264 force-pushed the jp/poc-c-runtime-quick-starts branch from 6aba671 to 25eb763 Compare October 21, 2026 09:09
@JPeer264 JPeer264 changed the title docs(js): [Experiment] Cloudflare quick starts in the Next.js and Nuxt guides docs(js): Add Cloudflare quick starts to the Next.js and Nuxt guides Oct 21, 2026
@JPeer264 JPeer264 mentioned this pull request Oct 21, 2026
Closed
1 of 6 tasks
@JPeer264
JPeer264 added this pull request to stack #20127 October 21, 2026 11:38
@JPeer264
JPeer264 force-pushed the jp/poc-c-runtime-quick-starts branch from 25eb763 to 3bdd530 Compare October 21, 2026 12:13
@JPeer264
JPeer264 force-pushed the jp/poc-c-runtime-quick-starts branch from 3bdd530 to 1385cf6 Compare October 25, 2026 22:25
@JPeer264
JPeer264 force-pushed the jp/poc-c-runtime-quick-starts branch from 1385cf6 to 04d1d99 Compare October 30, 2026 17:59
@JPeer264
JPeer264 removed this pull request from stack #20127 October 31, 2026 18:16
JPeer264 and others added 6 commits October 31, 2026 12:21
@JPeer264 @claude
docs(js): Add Cloudflare quick starts to the Next.js and Nuxt guides
43b6317 
The Next.js and Nuxt guides get a "Quick Start - Cloudflare" page below the
default quick start. Both quick starts move into getting-started-node and
getting-started-cloudflare includes per framework, so they share their
content. The Next.js on Cloudflare quick start now also covers wrapping
the Worker entry with withSentry.

The Next.js and Nuxt pages under Cloudflare > Frameworks and the Next.js
"Deploying on Cloudflare Workers" page redirect to the new pages.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@JPeer264 @claude
docs(js): Use the new quick start template on the Nuxt Cloudflare page
82e907c 
The Nuxt Cloudflare quick start now follows the template from the other
JavaScript quick starts: no feature checkboxes, every feature on in the
snippets, separate Send Logs and Send Application Metrics steps, and one
test error in Verify.

The release configuration in the shared Wrangler include is now an h4
without "(Optional)", because every page shows it under a Wrangler h3.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@JPeer264 @claude
docs(js): Show the Cloudflare quick starts as "Quick Start (Cloudflare)"
318585f 
The label reads as a variant of the Quick Start above it, without a
spaced hyphen that looks like a dash.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@JPeer264 @claude
docs(js): Move the Cloudflare framework quick starts into the framewo…
e70cba9 
…rk guides

The Astro, Remix, SvelteKit and TanStack Start pages under Cloudflare >
Frameworks move into their framework guides as "Quick Start - Cloudflare",
like Next.js and Nuxt. The Cloudflare parts of the Astro, Remix and
SvelteKit includes move into getting-started-cloudflare includes, because
PlatformSection only shows them on pages in the Cloudflare guide. The
framework list on the Cloudflare quick start links to the new pages, and
the old URLs redirect.

The TanStack Start page now installs @sentry/tanstackstart-react, which
its code imports, and its Wrangler and source maps sections render again.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@JPeer264 @claude
docs(js): Move the Hono Cloudflare page into the Hono guide
14edd96 
The Hono page under Cloudflare > Frameworks moves into the Hono guide as
"Quick Start - Cloudflare", with the full quick start steps. The Remix
"Cloudflare SDK Guide" page only linked to the Remix Cloudflare quick
start and to Hydrogen, so it redirects to the Remix Cloudflare quick
start, which now links to the Hydrogen guides.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@JPeer264 @claude
docs(js): Move the Hydrogen guides into the React Router and Remix gu…
8f2c283 
…ides

The Hydrogen with React Router guide moves into the React Router guide as
"Quick Start - Hydrogen", and the legacy Hydrogen with Remix guide moves
into the Remix guide. They were the last pages under Cloudflare >
Frameworks. The framework list on the Cloudflare quick start links to the
new page, and the old URLs redirect.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
JPeer264 and others added 3 commits October 31, 2026 12:22
@JPeer264 @claude
docs(js): Redirect Cloudflare > Frameworks to the Cloudflare quick start
4b274a9 
All framework pages moved into their framework guides, so the Cloudflare
> Frameworks page only listed links. The Cloudflare quick start already
links to every framework page, so the old URL now redirects there.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@JPeer264 @claude
docs(js): Use the new quick start template on the Cloudflare framewor…
4bc7b51 
…k pages

The Astro, Hono, Remix, SvelteKit and TanStack Start Cloudflare quick
starts and the Hydrogen quick start now follow the template from the
other JavaScript quick starts: no feature checkboxes, every feature on in
the snippets, separate Send Logs and Send Application Metrics steps, and
one test error in Verify. The Wrangler steps use the shared include
again.

The Hono Cloudflare page gets its own feature expandables, because it
supports neither Profiling nor the browser features. The legacy Hydrogen
with Remix guide only loses the "(Optional)" heading and gets the DSN
placeholder.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@JPeer264 @claude
docs(js): Show the moved quick starts as "Quick Start (Cloudflare)"
b91b19e 
Use the same label as the Next.js and Nuxt Cloudflare quick starts.
The Hydrogen quick start in the React Router guide becomes
"Quick Start (Hydrogen)".

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@JPeer264 JPeer264 changed the title docs(js): Add Cloudflare quick starts to the Next.js and Nuxt guides docs(js): Move the Cloudflare quick starts into the framework guides Oct 31, 2026
@JPeer264
JPeer264 force-pushed the jp/poc-c-runtime-quick-starts branch from 6b3fb32 to b91b19e Compare October 31, 2026 18:46
@JPeer264
JPeer264 added this pull request to stack #20366 October 31, 2026 18:47
@JPeer264 @claude
feat(js): Link the Node.js and Cloudflare quick starts of a framework
af8ed48 
Each framework guide now has a Node.js and a Cloudflare quick start, so
quick starts set `runtime` in their frontmatter. <RuntimeSelector /> at
the top of a quick start links the guide page and its child pages that
set `runtime`. The links are plain anchors, so they are also in the
Markdown export.

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

This branch was successfully deployed

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

Reviewers

No reviews

Assignees

No one assigned

Labels

Priority: Normal Docs review has no urgent deadline

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

1 participant

@JPeer264