docs(nextjs): Update getting started and manual setup for v11 - #19336
Draft
chargome wants to merge 1 commit into
Draft
docs(nextjs): Update getting started and manual setup for v11#19336chargome wants to merge 1 commit into
chargome wants to merge 1 commit into
Conversation
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>
|
The latest updates on your projects. Learn more about Vercel for GitHub.
1 Skipped Deployment
|
github-actions
Bot
added
Priority: Needs Triage
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
DESCRIBE YOUR PR
Updates the Next.js getting started and manual setup docs for SDK v11.
withSentryConfigmoves to@sentry/nextjs/config(20 occurrences) — it's no longer exported from@sentry/nextjssentry.client.config.tswithinstrumentation-client.tsand add the missinginstrumentation.ts/onRequestErrorstep. Under Turbopack the old file is ignored silently, so the page produced an app with no browser SDK and no server SDKonRouterTransitionStartunconditionally — the SDK warns whenever it's absent, regardless of whether tracing is enabledunstable_sentryWebpackPluginOptions,_experimental.turbopackApplicationKey, top-levelautomaticVercelMonitors/excludeServerRoutes. DocumentapplicationKey,buildTimeInstrumentation, unifiedreactComponentAnnotation,_experimental.vercelCronsMonitoringenableLogsreferences (removed in v11); state Next.js 14+ / Node 20.19.0+ prerequisitesStaying in draft until the v11 SDK and the wizard are published. These pages describe
@sentry/nextjs/config, which only exists in11.0.0-beta.2+, and the quick start page documents wizard output that still emits@sentry/nextjs(being updated separately).Not included:
inboundFiltersIntegration→eventFiltersIntegrationand thechildProcesssplit. Both link to sharedcommon/pages that still carry the old names, so they need a page rename plus redirect across every JS platform.Refs SDK-1493