Skip to content

feat(onboarding): Update Next.js onboarding for SDK v11 - #123911

Draft
chargome wants to merge 1 commit into
masterfrom
charlygomez/sdk-1435-update-the-javascript-nextjs-in-product-onboarding-for-v11
Draft

feat(onboarding): Update Next.js onboarding for SDK v11#123911
chargome wants to merge 1 commit into
masterfrom
charlygomez/sdk-1435-update-the-javascript-nextjs-in-product-onboarding-for-v11

Conversation

@chargome

@chargome chargome commented Sep 9, 2026

Copy link
Copy Markdown
Member

Update the in-product Next.js onboarding for @sentry/nextjs v11.

  • State that the SDK requires Next.js 14 or later in the install step.
  • Import withSentryConfig from @sentry/nextjs/config in the profiling next.config snippet, and label the ESM tab next.config.mjs. The root export is removed in v11. The ./config entry point already exists in 10.x, so the snippet also works for users who have not upgraded yet.
  • Drop the paragraph about SDK versions 7.57.x and below needing tracing enabled for distributed tracing.
  • Remove browserTracingIntegration from the distributed tracing snippet, since the Next.js SDK adds it by default.
  • Fix "React project" to "Next.js project" and "NextJS" to "Next.js" in the performance onboarding, and use a consistent (js|ts) suffix for the three config file names.

Checked and unchanged: reactComponentAnnotation, enableOpenTelemetrySetup and sendDefaultPii do not appear in this onboarding, the agent monitoring step already targets sentry.server.config only, and all docs links resolve.

closes SDK-1435

State the Next.js 14 minimum in the install step, import withSentryConfig
from @sentry/nextjs/config in the profiling next.config snippet since the
root export is removed in v11, and drop the stale pre-7.57 tracing note
and the redundant browserTracingIntegration from the distributed tracing
snippet. Fix React/NextJS naming in the performance onboarding.

Refs SDK-1435
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012tmtndCp2gfsHQNhQ8hH5i
@chargome chargome self-assigned this Sep 9, 2026
@linear-code

linear-code Bot commented Sep 9, 2026

Copy link
Copy Markdown

SDK-1435

@github-actions github-actions Bot added the Scope: Frontend Automatically applied to PRs that change frontend components label Sep 9, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Scope: Frontend Automatically applied to PRs that change frontend components

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant