Skip to content

docs(nextjs): Update getting started and manual setup for v11 - #19336

Merged
chargome merged 5 commits into
js-v11-docsfrom
charlygomez/sdk-1493-nextjs-getting-started-manual-setup
Sep 22, 2026
Merged

chargome merged 5 commits into
js-v11-docsfrom
charlygomez/sdk-1493-nextjs-getting-started-manual-setup

Conversation

@chargome

@chargome chargome commented Sep 10, 2026 •

Copy link
Copy Markdown
Member

DESCRIBE YOUR PR

Updates the Next.js getting started and manual setup docs for SDK v11.

  • withSentryConfig moves to @sentry/nextjs/config (20 occurrences) — it's no longer exported from @sentry/nextjs
  • Pages Router: replace sentry.client.config.ts with instrumentation-client.ts and add the missing instrumentation.ts / onRequestError step. Under Turbopack the old file is ignored silently, so the page produced an app with no browser SDK and no server SDK
  • Export onRouterTransitionStart unconditionally — the SDK warns whenever it's absent, regardless of whether tracing is enabled
  • Drop removed build options: unstable_sentryWebpackPluginOptions, _experimental.turbopackApplicationKey, top-level automaticVercelMonitors / excludeServerRoutes. Document applicationKey, buildTimeInstrumentation, unified reactComponentAnnotation, _experimental.vercelCronsMonitoring
  • Remove enableLogs references (removed in v11); state Next.js 14+ / Node 20.19.0+ prerequisites

Staying in draft until the v11 SDK and the wizard are published. These pages describe @sentry/nextjs/config, which only exists in 11.0.0-beta.2+, and the quick start page documents wizard output that still emits @sentry/nextjs (being updated separately).

Not included: inboundFiltersIntegration → eventFiltersIntegration and the childProcess split. Both link to shared common/ pages that still carry the old names, so they need a page rename plus redirect across every JS platform.

Refs SDK-1493
Refs SDK-1483

Audited the Next.js getting started and manual setup pages against
sentry-javascript develop (dccf25d478).

withSentryConfig is no longer exported from @sentry/nextjs and moves to the
@sentry/nextjs/config subpath. The Pages Router page initialized the browser SDK
in sentry.client.config.ts, which Turbopack ignores silently, and never added
instrumentation.ts, so following it produced an app with neither a browser nor a
server SDK. Export onRouterTransitionStart unconditionally, since the SDK warns
whenever it is absent rather than only when tracing is enabled.

Drop build options removed in v11 and document their replacements, remove
enableLogs, and state the Next.js 14 and Node 20.19.0 minimums.

Also fix a dead link in the crons include and two SdkOption anchors that used
slugified names instead of the verbatim option name.

Refs SDK-1493
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@chargome chargome self-assigned this Sep 10, 2026
@vercel

vercel Bot commented Sep 10, 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 Sep 22, 2026 3:15pm UTC
1 Skipped Deployment
Project Deployment Actions Updated
develop-docs Ignored Ignored Preview Sep 22, 2026 3:15pm UTC

Request Review

@linear-code

linear-code Bot commented Sep 10, 2026 •

Copy link
Copy Markdown

SDK-1493

SDK-1483

@github-actions github-actions Bot added the Priority: Normal Docs review has no urgent deadline label Sep 10, 2026
@github-actions github-actions Bot added Priority: Needs Triage The PR description is missing valid priority information and removed Priority: Normal Docs review has no urgent deadline labels Sep 11, 2026
@chargome
chargome requested a review from JPeer264 September 17, 2026 09:36
@andreiborza
andreiborza changed the base branch from master to js-v11-docs September 22, 2026 12:14
@andreiborza
andreiborza marked this pull request as ready for review September 22, 2026 13:17
@codeowner-assignment
codeowner-assignment Bot requested a review from a team September 22, 2026 13:17
@github-actions

Copy link
Copy Markdown
Contributor

Please update the IS YOUR CHANGE URGENT? section of the PR description:

  • Select exactly one option.
  • If you selected an urgent or other deadline, provide the date as YYYY-MM-DD.

This information helps the Docs team prioritize your review.

chargome and others added 3 commits September 22, 2026 17:02
…ter.mdx

Co-authored-by: Andrei <168741329+andreiborza@users.noreply.github.com>
…ter.mdx

Co-authored-by: Andrei <168741329+andreiborza@users.noreply.github.com>
…etup.mdx

Co-authored-by: Andrei <168741329+andreiborza@users.noreply.github.com>
Address review feedback: drop the alert about the removed
unstable_sentryWebpackPluginOptions escape hatch and link to the build
configuration reference from the preceding sentence instead.

Refs SDK-1493
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@chargome
chargome merged commit 5c3e765 into js-v11-docs Sep 22, 2026
8 checks passed
@chargome
chargome deleted the charlygomez/sdk-1493-nextjs-getting-started-manual-setup branch September 22, 2026 15:23

This branch was successfully deployed

1 active deployment
Preview – sentry-docs — ad02c67e Deployed Sep 22, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

js-v11-docs Priority: Needs Triage The PR description is missing valid priority information

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants