Skip to content

docs(cloudflare): Document the vinext Worker entry wrapping of the Vite plugin - #20094

Open
sentry-junior[bot] wants to merge 2 commits into
masterfrom
jp/cloudflare-nextjs-vinext
Open

sentry-junior[bot] wants to merge 2 commits into
masterfrom
jp/cloudflare-nextjs-vinext

Conversation

@sentry-junior

@sentry-junior sentry-junior Bot commented Oct 19, 2026 •

Copy link
Copy Markdown
Contributor

DESCRIBE YOUR PR

Since SDK 11.6.0, the Cloudflare Vite plugin wraps the Worker entry of a vinext build with withSentry from @sentry/nextjs/cloudflare when @sentry/nextjs is installed (getsentry/sentry-javascript#25000). It works out of the box, so this adds a short "Wrap the Worker Entry With vinext" section to the Next.js on Cloudflare page that points to the existing Vite plugin page, next to the OpenNext custom Worker setup from #19874.

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

EXTRA RESOURCES

via Jan Peer Stöcklmair.

--

View Junior Session [Sentry]

@vercel

vercel Bot commented Oct 19, 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 25, 2026 11:24am UTC
1 Skipped Deployment
Project Deployment Actions Updated
develop-docs Ignored Ignored Preview Oct 25, 2026 11:24am UTC

Request Review

…te plugin

Co-Authored-By: Jan VamPeer Stöcklmair <jan.peer@sentry.io>
Co-Authored-By: Jan VamPeer Stöcklmair <jan.peer@sentry.io>
@cursor

cursor Bot commented Oct 25, 2026 •

Copy link
Copy Markdown
Contributor

The plan checks that the new vinext wrap section appears on the live guide. It also checks page loads on that guide, JavaScript docs 404s, and client errors on nearby guides. An issue escalates when the section is missing, those loads fall away, 404s jump, or those errors appear.

Services: sentry-docs.

Mention @change-monitor in a comment to update the plan.

Plan

What changed

Requests to the Next.js on Cloudflare guide now include a vinext wrap section. Vinext readers skip the OpenNext custom Worker and use the Vite plugin wrap instead.

sentry-docs must deploy before this page is live. The path is /platforms/javascript/guides/cloudflare/frameworks/nextjs/. The rollouts workflow maps the Vercel production project sentry-docs to this service.

Risk

A bad MDX build can 404 this page or drop the OpenNext wrap section. The new Vite plugin link can 404. Sibling Cloudflare guides share the same catch-all route.

Intended effect

This is a documentation change. No metric counts the new heading.

Confirm the live guide shows the heading Wrap the Worker Entry With vinext. Also confirm the skip link to that heading.

Absent: the live guide still documents OpenNext only. The vinext heading is missing.

Signal Baseline Rule Source
Heading Wrap the Worker Entry With vinext Absent on the live guide Present after deploy GET https://docs.sentry.io/platforms/javascript/guides/cloudflare/frameworks/nextjs/ at 2026-10-25T12:06Z. Pre-deploy body had OpenNext only.

Regression watch

Client errors on this guide family are the symptom-class signal. Page loads on this path show whether the page still renders. JavaScript path 404s cover a broken Vite plugin link only as a coarse bucket.

Signal Baseline Rule Source
Client errors on Cloudflare JS guides 0 events per 24h and per 48h Hold at 0 Sentry errors, org sentry, project docs. Query environment:production transaction:"*/platforms/javascript/guides/cloudflare/*". Windows 2026-10-24T12:06:08Z to 2026-10-25T12:06:08Z and 2026-10-23T12:06:08Z to 2026-10-25T12:06:08Z.
docs.page.load on this page 6 loads per 48h Hold above 0 in a matching 48h window. A 48h count of 0 means the page likely failed to render. Low volume. A quiet 24h can be noise. Sentry metrics, org sentry, project docs. Query path:*cloudflare/frameworks/nextjs*. Field sum(value, docs.page.load, counter, none). Window 2026-10-23T12:06:08Z to 2026-10-25T12:06:08Z.
docs.page.not_found for platforms/javascript 93 counts per 48h. A second query with environment:production and path wildcard returned 23 counts per 24h. Do not subtract these. The queries differ. Hold near each matching window. Escalate if a rerun rises far above that window. Day-to-day split with one query is not measured. Sentry metrics, org sentry, project docs. 48h query requested_path:"platforms/javascript". 24h query environment:production requested_path:*platforms/javascript*. Field sum(value, docs.page.not_found, counter, none). Windows 2026-10-23T12:06:08Z to 2026-10-25T12:06:08Z and 2026-10-24T12:06:08Z to 2026-10-25T12:06:08Z.

Not observable

Page-level 404 share is not available. docs.page.not_found stores only the first two path segments. The Vite plugin target is not split.

Pageload span count and p95 for transaction /platforms/javascript/guides/cloudflare/frameworks/nextjs/ returned no rows in 24h and in 7d. Client traces sample at 30%. Web vitals for this page are therefore unknown.

The 24h split of docs.page.load for this path timed out. Only the 48h total of 6 is known.

Pre-ship error rate as a share of this page's loads is unknown. Family errors are 0. Family load volume was not measured.

This branch was successfully deployed

1 active deployment
Preview – sentry-docs — 467718dc Deployed Oct 25, 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