Skip to content

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

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
JPeer264 merged 2 commits into from
Oct 27, 2026
Merged

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

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
0738dc8
docs(cloudflare): Document the vinext Worker entry wrapping of the Vi…
sentry-junior[bot] Oct 21, 2026
467718d
docs(cloudflare): Trim vinext section to point at the Vite plugin
sentry-junior[bot] Oct 25, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 9 additions & 1 deletion docs/platforms/javascript/guides/cloudflare/frameworks/nextjs.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ Before you begin, make sure you have:

- A Sentry [account](https://sentry.io/signup/) and [project](/product/projects/)
- A [Cloudflare Workers project](https://dash.cloudflare.com/workers/overview)
- A Next.js application configured for Cloudflare Workers with [OpenNext](https://opennext.js.org/cloudflare)
- A Next.js application configured for Cloudflare Workers with [OpenNext](https://opennext.js.org/cloudflare) or [vinext](https://github.com/cloudflare/vinext)
- The Sentry SDK [installed and configured](/platforms/javascript/guides/nextjs/) in your Next.js application

<Alert level="info">
Expand Down Expand Up @@ -57,6 +57,8 @@ compatibility_date = "2025-08-16"

<AvailableSince version="11.6.0" />

If you build your app with vinext, skip to [Wrap the Worker Entry With vinext](#wrap-the-worker-entry-with-vinext).

On Cloudflare Workers, your Next.js app runs inside the Worker entry that OpenNext generates (`.open-next/worker.js`). Wrap this entry with `withSentry` from `@sentry/nextjs/cloudflare` to get the same Next.js spans as on Node.js, plus Cloudflare data such as spans for D1 queries. Each request gets one `http.server` span with the name of the Next.js route, and the Next.js spans become its children.

`@sentry/nextjs` depends on `@sentry/cloudflare`, so you don't need to install another package.
Expand Down Expand Up @@ -97,6 +99,12 @@ Then, point `main` in your Wrangler configuration to this file:
main = "./worker.ts"
```

### Wrap the Worker Entry With vinext

<AvailableSince version="11.6.0" />

With [vinext](https://github.com/cloudflare/vinext), you don't need a custom Worker. Add the <PlatformLink to="/install/vite-plugin/">Sentry Vite plugin</PlatformLink> to your Vite config, and it wraps your Worker entry with `withSentry` from `@sentry/nextjs/cloudflare` automatically.

### Server and Edge Configuration in the Worker

In the Worker, `withSentry` creates the Sentry client. `Sentry.init()` in `sentry.server.config.ts` and `sentry.edge.config.ts` still runs, but it creates no client and only applies the `release` option. Set all other options in `withSentry`.
Expand Down
Loading