From 71f7ba9e3fc3b4726e47e623cf9fbfa7c16854c5 Mon Sep 17 00:00:00 2001 From: Cody De Arkland Date: Sun, 9 Nov 2025 22:41:50 -0800 Subject: [PATCH 01/23] feat: Restructure JavaScript SDK documentation organization - Move apis.mdx from /common/ to /common/configuration/ - Move sampling.mdx from /common/configuration/ to /common/ - Add redirects for both old paths to maintain existing links This reorganization improves the documentation structure by: - Placing APIs documentation with other configuration topics - Elevating sampling to a top-level concept (not just a config option) All existing URLs will automatically redirect to the new locations. --- .../common/{ => configuration}/apis.mdx | 2 +- .../common/{configuration => }/sampling.mdx | 2 +- redirects.js | 16 ++++++++++++++++ 3 files changed, 18 insertions(+), 2 deletions(-) rename docs/platforms/javascript/common/{ => configuration}/apis.mdx (99%) rename docs/platforms/javascript/common/{configuration => }/sampling.mdx (99%) diff --git a/docs/platforms/javascript/common/apis.mdx b/docs/platforms/javascript/common/configuration/apis.mdx similarity index 99% rename from docs/platforms/javascript/common/apis.mdx rename to docs/platforms/javascript/common/configuration/apis.mdx index 0c22a8482fc8b..dd8d5d51dcc8c 100644 --- a/docs/platforms/javascript/common/apis.mdx +++ b/docs/platforms/javascript/common/configuration/apis.mdx @@ -2,7 +2,7 @@ title: APIs description: "Learn more about APIs of the SDK." customCanonicalTag: "/platforms/javascript/apis/" -sidebar_order: 3 +sidebar_order: 1 --- This page shows all available top-level APIs of the SDK. You can use these APIs as the primary way to: diff --git a/docs/platforms/javascript/common/configuration/sampling.mdx b/docs/platforms/javascript/common/sampling.mdx similarity index 99% rename from docs/platforms/javascript/common/configuration/sampling.mdx rename to docs/platforms/javascript/common/sampling.mdx index 88bb3498add9e..7db54b4633ff3 100644 --- a/docs/platforms/javascript/common/configuration/sampling.mdx +++ b/docs/platforms/javascript/common/sampling.mdx @@ -1,7 +1,7 @@ --- title: Sampling description: "Learn how to configure the volume of error and transaction events sent to Sentry." -sidebar_order: 50 +sidebar_order: 5.5 --- Adding Sentry to your app gives you a great deal of very valuable information about errors and performance you wouldn't otherwise get. And lots of information is good -- as long as it's the right information, at a reasonable volume. diff --git a/redirects.js b/redirects.js index 1b551ce15b746..37dae48fbd1f2 100644 --- a/redirects.js +++ b/redirects.js @@ -1118,6 +1118,22 @@ const userDocsRedirects = [ source: '/platforms/javascript/guides/:guide/profiling/browser-profiling/', destination: '/platforms/javascript/guides/:guide/profiling/', }, + { + source: '/platforms/javascript/apis/', + destination: '/platforms/javascript/configuration/apis/', + }, + { + source: '/platforms/javascript/guides/:guide/apis/', + destination: '/platforms/javascript/guides/:guide/configuration/apis/', + }, + { + source: '/platforms/javascript/configuration/sampling/', + destination: '/platforms/javascript/sampling/', + }, + { + source: '/platforms/javascript/guides/:guide/configuration/sampling/', + destination: '/platforms/javascript/guides/:guide/sampling/', + }, { source: '/platforms/javascript/guides/:guide/profiling/node-profiling/', destination: '/platforms/javascript/guides/:guide/profiling/', From 3fd4f52a25958148a6ecff9aea6e48c5c59f7199 Mon Sep 17 00:00:00 2001 From: Cody De Arkland Date: Sun, 9 Nov 2025 22:42:20 -0800 Subject: [PATCH 02/23] feat: Update sidebar ordering for key JavaScript SDK features - Move Logs to sidebar_order: 2 (add 'new' badge) - Move Metrics to sidebar_order: 3 (add 'beta' badge) - Move Session Replay to sidebar_order: 4 - Move Tracing to sidebar_order: 5 (add section separator) This reorders the navigation to prioritize newer features (Logs, Metrics) higher in the sidebar for better discoverability. --- docs/platforms/javascript/common/logs/index.mdx | 3 ++- docs/platforms/javascript/common/metrics/index.mdx | 3 ++- docs/platforms/javascript/common/session-replay/index.mdx | 2 +- docs/platforms/javascript/common/tracing/index.mdx | 3 ++- 4 files changed, 7 insertions(+), 4 deletions(-) diff --git a/docs/platforms/javascript/common/logs/index.mdx b/docs/platforms/javascript/common/logs/index.mdx index 50022148b3356..d4c88ad361778 100644 --- a/docs/platforms/javascript/common/logs/index.mdx +++ b/docs/platforms/javascript/common/logs/index.mdx @@ -2,7 +2,8 @@ title: Set Up Logs sidebar_title: Logs description: "Structured logs allow you to send, view and query logs sent from your applications within Sentry." -sidebar_order: 5755 +sidebar_order: 2 +new: true notSupported: - javascript.deno - javascript.cordova diff --git a/docs/platforms/javascript/common/metrics/index.mdx b/docs/platforms/javascript/common/metrics/index.mdx index 5e5583a4b6a0b..7883c56718dc2 100644 --- a/docs/platforms/javascript/common/metrics/index.mdx +++ b/docs/platforms/javascript/common/metrics/index.mdx @@ -2,7 +2,8 @@ title: Set Up Metrics sidebar_title: Metrics description: "Metrics allow you to send, view and query counters, gauges and measurements from your Sentry-configured apps to track application health and drill down into related traces, logs, and errors." -sidebar_order: 5755 +sidebar_order: 3 +beta: true --- With Sentry Metrics, you can send counters, gauges, distributions, and sets from your applications to Sentry. Once in Sentry, these metrics can be viewed alongside relevant errors, and searched using their individual attributes. diff --git a/docs/platforms/javascript/common/session-replay/index.mdx b/docs/platforms/javascript/common/session-replay/index.mdx index 2f0a0749385ac..c5e349f8d31a5 100644 --- a/docs/platforms/javascript/common/session-replay/index.mdx +++ b/docs/platforms/javascript/common/session-replay/index.mdx @@ -1,7 +1,7 @@ --- title: Set Up Session Replay sidebar_title: Session Replay -sidebar_order: 5500 +sidebar_order: 4 notSupported: - javascript.cordova - javascript.wasm diff --git a/docs/platforms/javascript/common/tracing/index.mdx b/docs/platforms/javascript/common/tracing/index.mdx index 5761afcadeb79..e5f17178389ea 100644 --- a/docs/platforms/javascript/common/tracing/index.mdx +++ b/docs/platforms/javascript/common/tracing/index.mdx @@ -2,7 +2,8 @@ title: Set Up Tracing sidebar_title: Tracing description: "Learn how to enable tracing in your app." -sidebar_order: 4000 +sidebar_order: 5 +section_end_divider: true --- With [tracing](/product/insights/overview/), Sentry automatically tracks your software performance across your application services, measuring metrics like throughput and latency, and displaying the impact of errors across multiple systems. From 408a1d85613617aea0400c9e3731a43e2c712772 Mon Sep 17 00:00:00 2001 From: Cody De Arkland Date: Sun, 9 Nov 2025 22:42:23 -0800 Subject: [PATCH 03/23] feat: Rename Configuration to Advanced Configuration and adjust ordering - Rename 'Configuration' to 'Advanced Configuration' for clarity - Add explicit sidebar_title - Move to sidebar_order: 100 to position at end of navigation This helps differentiate basic setup from advanced configuration topics. --- docs/platforms/javascript/common/configuration/index.mdx | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/docs/platforms/javascript/common/configuration/index.mdx b/docs/platforms/javascript/common/configuration/index.mdx index a62e57d704dce..dc9d13c16293e 100644 --- a/docs/platforms/javascript/common/configuration/index.mdx +++ b/docs/platforms/javascript/common/configuration/index.mdx @@ -1,7 +1,8 @@ --- -title: Configuration +title: Advanced Configuration +sidebar_title: Advanced Configuration description: "Learn about additional configuration options for the JavaScript SDKs." -sidebar_order: 2 +sidebar_order: 100 --- From 9cb5a0d3cae7ada0acf1be1c1b8f483321c01620 Mon Sep 17 00:00:00 2001 From: Cody De Arkland Date: Mon, 10 Nov 2025 18:21:27 -0800 Subject: [PATCH 04/23] Correcting the ordering of sidenav for javascript frameworks --- .../javascript/common/configuration/index.mdx | 6 +- .../javascript/common/crons/index.mdx | 2 +- .../common/data-management/index.mdx | 2 +- .../common/enriching-events/index.mdx | 2 +- .../javascript/common/feature-flags/index.mdx | 2 +- .../javascript/common/logs/index.mdx | 2 +- .../javascript/common/metrics/index.mdx | 2 +- .../javascript/common/opentelemetry/index.mdx | 2 +- .../javascript/common/profiling/index.mdx | 2 +- docs/platforms/javascript/common/sampling.mdx | 2 +- .../common/session-replay/index.mdx | 2 +- .../javascript/common/sourcemaps/index.mdx | 2 +- .../javascript/common/tracing/index.mdx | 2 +- .../javascript/common/usage/index.mdx | 4 +- .../javascript/common/user-feedback/index.mdx | 2 +- .../guides/astro/profiling/index.mdx | 2 +- .../guides/gatsby/profiling/index.mdx | 2 +- .../javascript/guides/nextjs/index.mdx | 83 ++++++++++++++++--- .../guides/nextjs/profiling/index.mdx | 2 +- .../guides/nuxt/profiling/index.mdx | 2 +- .../guides/react-router/profiling/index.mdx | 2 +- .../guides/remix/profiling/index.mdx | 2 +- .../guides/solidstart/profiling/index.mdx | 2 +- .../guides/sveltekit/profiling/index.mdx | 2 +- .../tanstackstart-react/profiling/index.mdx | 2 +- src/components/splitLayout/style.module.scss | 7 +- 26 files changed, 106 insertions(+), 38 deletions(-) diff --git a/docs/platforms/javascript/common/configuration/index.mdx b/docs/platforms/javascript/common/configuration/index.mdx index dc9d13c16293e..74e5d860aa7b1 100644 --- a/docs/platforms/javascript/common/configuration/index.mdx +++ b/docs/platforms/javascript/common/configuration/index.mdx @@ -1,8 +1,8 @@ --- -title: Advanced Configuration -sidebar_title: Advanced Configuration +title: Extended Configuration +sidebar_title: Extended Configuration description: "Learn about additional configuration options for the JavaScript SDKs." -sidebar_order: 100 +sidebar_order: 10 --- diff --git a/docs/platforms/javascript/common/crons/index.mdx b/docs/platforms/javascript/common/crons/index.mdx index d8727d026c0fd..4527535b66afa 100644 --- a/docs/platforms/javascript/common/crons/index.mdx +++ b/docs/platforms/javascript/common/crons/index.mdx @@ -2,7 +2,7 @@ title: Set Up Crons sidebar_title: Crons description: "Sentry Crons allows you to monitor the uptime and performance of any scheduled, recurring job in your application." -sidebar_order: 5750 +sidebar_order: 13 supported: - javascript.nextjs - javascript.sveltekit diff --git a/docs/platforms/javascript/common/data-management/index.mdx b/docs/platforms/javascript/common/data-management/index.mdx index ff50566053576..6bda59dc6db7e 100644 --- a/docs/platforms/javascript/common/data-management/index.mdx +++ b/docs/platforms/javascript/common/data-management/index.mdx @@ -1,7 +1,7 @@ --- title: Data Management description: Learn about different ways to scrub data within your SDK before it gets sent to Sentry. -sidebar_order: 7 +sidebar_order: 16 --- diff --git a/docs/platforms/javascript/common/enriching-events/index.mdx b/docs/platforms/javascript/common/enriching-events/index.mdx index 050223cad6110..e1c3c9a01d576 100644 --- a/docs/platforms/javascript/common/enriching-events/index.mdx +++ b/docs/platforms/javascript/common/enriching-events/index.mdx @@ -1,7 +1,7 @@ --- title: Enriching Events description: Add additional data to your events to make them easier to debug. -sidebar_order: 5 +sidebar_order: 9 --- In addition to the data that the Sentry SDK automatically captures, you can add additional data to events to help you debug them. diff --git a/docs/platforms/javascript/common/feature-flags/index.mdx b/docs/platforms/javascript/common/feature-flags/index.mdx index d003e03e02df8..f1b7163c26571 100644 --- a/docs/platforms/javascript/common/feature-flags/index.mdx +++ b/docs/platforms/javascript/common/feature-flags/index.mdx @@ -1,7 +1,7 @@ --- title: Set Up Feature Flags sidebar_title: Feature Flags -sidebar_order: 7000 +sidebar_order: 15 description: With Feature Flags, Sentry tracks feature flag evaluations in your application, keeps an audit log of feature flag changes, and reports any suspicious updates that may have caused an error. --- diff --git a/docs/platforms/javascript/common/logs/index.mdx b/docs/platforms/javascript/common/logs/index.mdx index d4c88ad361778..58739cc214fe9 100644 --- a/docs/platforms/javascript/common/logs/index.mdx +++ b/docs/platforms/javascript/common/logs/index.mdx @@ -2,7 +2,7 @@ title: Set Up Logs sidebar_title: Logs description: "Structured logs allow you to send, view and query logs sent from your applications within Sentry." -sidebar_order: 2 +sidebar_order: 3 new: true notSupported: - javascript.deno diff --git a/docs/platforms/javascript/common/metrics/index.mdx b/docs/platforms/javascript/common/metrics/index.mdx index 7883c56718dc2..d0fb85ff61942 100644 --- a/docs/platforms/javascript/common/metrics/index.mdx +++ b/docs/platforms/javascript/common/metrics/index.mdx @@ -2,7 +2,7 @@ title: Set Up Metrics sidebar_title: Metrics description: "Metrics allow you to send, view and query counters, gauges and measurements from your Sentry-configured apps to track application health and drill down into related traces, logs, and errors." -sidebar_order: 3 +sidebar_order: 4 beta: true --- diff --git a/docs/platforms/javascript/common/opentelemetry/index.mdx b/docs/platforms/javascript/common/opentelemetry/index.mdx index 83e98b38e24c6..6044f1c3ce6d6 100644 --- a/docs/platforms/javascript/common/opentelemetry/index.mdx +++ b/docs/platforms/javascript/common/opentelemetry/index.mdx @@ -1,7 +1,7 @@ --- title: OpenTelemetry Support description: "Learn how to use OpenTelemetry with Sentry." -sidebar_order: 7000 +sidebar_order: 11 supported: - javascript.nextjs - javascript.node diff --git a/docs/platforms/javascript/common/profiling/index.mdx b/docs/platforms/javascript/common/profiling/index.mdx index a04da12b821ae..22e4c05438f5f 100644 --- a/docs/platforms/javascript/common/profiling/index.mdx +++ b/docs/platforms/javascript/common/profiling/index.mdx @@ -1,7 +1,7 @@ --- title: Set Up Profiling sidebar_title: Profiling -sidebar_order: 5000 +sidebar_order: 12 description: "Collect & view performance insights for JavaScript programs with Sentry's Profiling integrations. Get started with profiling to understand your application's performance." notSupported: - javascript.bun diff --git a/docs/platforms/javascript/common/sampling.mdx b/docs/platforms/javascript/common/sampling.mdx index 7db54b4633ff3..848c2e55499c8 100644 --- a/docs/platforms/javascript/common/sampling.mdx +++ b/docs/platforms/javascript/common/sampling.mdx @@ -1,7 +1,7 @@ --- title: Sampling description: "Learn how to configure the volume of error and transaction events sent to Sentry." -sidebar_order: 5.5 +sidebar_order: 8 --- Adding Sentry to your app gives you a great deal of very valuable information about errors and performance you wouldn't otherwise get. And lots of information is good -- as long as it's the right information, at a reasonable volume. diff --git a/docs/platforms/javascript/common/session-replay/index.mdx b/docs/platforms/javascript/common/session-replay/index.mdx index c5e349f8d31a5..ae713a1867a48 100644 --- a/docs/platforms/javascript/common/session-replay/index.mdx +++ b/docs/platforms/javascript/common/session-replay/index.mdx @@ -1,7 +1,7 @@ --- title: Set Up Session Replay sidebar_title: Session Replay -sidebar_order: 4 +sidebar_order: 6 notSupported: - javascript.cordova - javascript.wasm diff --git a/docs/platforms/javascript/common/sourcemaps/index.mdx b/docs/platforms/javascript/common/sourcemaps/index.mdx index 0a67387ae019b..f7f96a759b9b7 100644 --- a/docs/platforms/javascript/common/sourcemaps/index.mdx +++ b/docs/platforms/javascript/common/sourcemaps/index.mdx @@ -1,6 +1,6 @@ --- title: Source Maps -sidebar_order: 3 +sidebar_order: 5 description: "Upload your source maps to Sentry to enable readable stack traces in your errors." --- diff --git a/docs/platforms/javascript/common/tracing/index.mdx b/docs/platforms/javascript/common/tracing/index.mdx index e5f17178389ea..8b62ee2bd86fc 100644 --- a/docs/platforms/javascript/common/tracing/index.mdx +++ b/docs/platforms/javascript/common/tracing/index.mdx @@ -2,7 +2,7 @@ title: Set Up Tracing sidebar_title: Tracing description: "Learn how to enable tracing in your app." -sidebar_order: 5 +sidebar_order: 7 section_end_divider: true --- diff --git a/docs/platforms/javascript/common/usage/index.mdx b/docs/platforms/javascript/common/usage/index.mdx index d402ccad46bb8..04026f151fae6 100644 --- a/docs/platforms/javascript/common/usage/index.mdx +++ b/docs/platforms/javascript/common/usage/index.mdx @@ -1,7 +1,7 @@ --- -title: Capturing Errors and Events +title: Capturing Errors description: "Learn how to use the SDK to manually capture errors and other events." -sidebar_order: 4 +sidebar_order: 2 --- Sentry's SDK hooks into your runtime environment and automatically reports errors, uncaught exceptions, and unhandled rejections as well as other types of errors depending on the platform. diff --git a/docs/platforms/javascript/common/user-feedback/index.mdx b/docs/platforms/javascript/common/user-feedback/index.mdx index 033750ca59a14..bfc828b7eff19 100644 --- a/docs/platforms/javascript/common/user-feedback/index.mdx +++ b/docs/platforms/javascript/common/user-feedback/index.mdx @@ -2,7 +2,7 @@ title: Set Up User Feedback sidebar_title: User Feedback description: Learn how to enable User Feedback in your app. -sidebar_order: 6000 +sidebar_order: 14 og_image: /og-images/platforms-javascript-common-user-feedback.png --- diff --git a/docs/platforms/javascript/guides/astro/profiling/index.mdx b/docs/platforms/javascript/guides/astro/profiling/index.mdx index 358ff175b7055..7521daa475de0 100644 --- a/docs/platforms/javascript/guides/astro/profiling/index.mdx +++ b/docs/platforms/javascript/guides/astro/profiling/index.mdx @@ -1,7 +1,7 @@ --- title: Set Up Profiling sidebar_title: Profiling -sidebar_order: 5000 +sidebar_order: 12 description: "Collect & view performance insights for JavaScript programs with Sentry's Profiling integrations." --- diff --git a/docs/platforms/javascript/guides/gatsby/profiling/index.mdx b/docs/platforms/javascript/guides/gatsby/profiling/index.mdx index 358ff175b7055..7521daa475de0 100644 --- a/docs/platforms/javascript/guides/gatsby/profiling/index.mdx +++ b/docs/platforms/javascript/guides/gatsby/profiling/index.mdx @@ -1,7 +1,7 @@ --- title: Set Up Profiling sidebar_title: Profiling -sidebar_order: 5000 +sidebar_order: 12 description: "Collect & view performance insights for JavaScript programs with Sentry's Profiling integrations." --- diff --git a/docs/platforms/javascript/guides/nextjs/index.mdx b/docs/platforms/javascript/guides/nextjs/index.mdx index 3306adfe15844..1136a6b128143 100644 --- a/docs/platforms/javascript/guides/nextjs/index.mdx +++ b/docs/platforms/javascript/guides/nextjs/index.mdx @@ -29,17 +29,19 @@ Select which Sentry features you'd like to install in addition to Error Monitori ]} /> -## Step 1: Install + -To install Sentry using the installation wizard, run the following command within your project: + -```bash -npx @sentry/wizard@latest -i nextjs -``` +## Install -The wizard then guides you through the setup process, asking you to enable additional (optional) Sentry features for your application beyond error monitoring. + + + - +To install Sentry using the installation wizard, run the command on the right within your project directory. + +The wizard guides you through the setup process, asking you to enable additional (optional) Sentry features for your application beyond error monitoring. This guide assumes that you enable all features and allow the wizard to create an example page and route. You can add or remove features at any time, but setting them up now will save you the effort of configuring them manually later. @@ -54,12 +56,45 @@ This guide assumes that you enable all features and allow the wizard to create a -## Step 2: Configure + + + +```bash +npx @sentry/wizard@latest -i nextjs +``` + + + + + +## Configure If you prefer to configure Sentry manually, here are the configuration files the wizard would create: + + + + ### Client-Side Configuration +The wizard creates a client configuration file that initializes the Sentry SDK in your browser. + +The configuration includes your DSN (Data Source Name), which connects your app to your Sentry project, and enables the features you selected during installation. + +Key configuration options: + +- **`sendDefaultPii`** - Adds request headers and user IP for better debugging +- **`integrations`** - Enables features like Session Replay and User Feedback +- **`enableLogs`** - Forwards console logs to Sentry +- **`tracesSampleRate`** - Controls performance monitoring sampling (1.0 = 100%) +- **`replaysSessionSampleRate`** - Captures 10% of all sessions +- **`replaysOnErrorSampleRate`** - Captures 100% of sessions with errors + +The `onRouterTransitionStart` export enables automatic performance tracking for Next.js page transitions. + + + + ```javascript {tabTitle:Client} {filename:instrumentation-client.(js|ts)} import * as Sentry from "@sentry/nextjs"; @@ -111,8 +146,32 @@ export const onRouterTransitionStart = Sentry.captureRouterTransitionStart; // ___PRODUCT_OPTION_END___ performance ``` + + + + + + ### Server-Side Configuration +The wizard also creates a server configuration file for Node.js and Edge runtimes. + +This configuration captures errors from: +- API routes +- Server components +- Server actions +- Middleware +- Edge functions + +The server configuration is simpler than the client configuration because some features (like Session Replay and User Feedback) are client-only. + +**Note:** Make sure `sendDefaultPii` is set to `true` if you want to capture user context with server-side errors. + +For more advanced configuration options or to set up Sentry manually, check out our [manual setup guide](/platforms/javascript/guides/nextjs/manual-setup/). + + + + ```javascript {tabTitle:Server} {filename:sentry.server.config.(js|ts)} import * as Sentry from "@sentry/nextjs"; @@ -139,9 +198,11 @@ Sentry.init({ }); ``` -For detailed manual setup instructions, see our [manual setup guide](/platforms/javascript/guides/nextjs/manual-setup/). + + + -## Step 3: Verify Your Setup +## Verify Your Setup @@ -188,3 +249,5 @@ Our next recommended steps for you are: - [Get support](https://sentry.zendesk.com/hc/en-us/) + + diff --git a/docs/platforms/javascript/guides/nextjs/profiling/index.mdx b/docs/platforms/javascript/guides/nextjs/profiling/index.mdx index 358ff175b7055..7521daa475de0 100644 --- a/docs/platforms/javascript/guides/nextjs/profiling/index.mdx +++ b/docs/platforms/javascript/guides/nextjs/profiling/index.mdx @@ -1,7 +1,7 @@ --- title: Set Up Profiling sidebar_title: Profiling -sidebar_order: 5000 +sidebar_order: 12 description: "Collect & view performance insights for JavaScript programs with Sentry's Profiling integrations." --- diff --git a/docs/platforms/javascript/guides/nuxt/profiling/index.mdx b/docs/platforms/javascript/guides/nuxt/profiling/index.mdx index 358ff175b7055..7521daa475de0 100644 --- a/docs/platforms/javascript/guides/nuxt/profiling/index.mdx +++ b/docs/platforms/javascript/guides/nuxt/profiling/index.mdx @@ -1,7 +1,7 @@ --- title: Set Up Profiling sidebar_title: Profiling -sidebar_order: 5000 +sidebar_order: 12 description: "Collect & view performance insights for JavaScript programs with Sentry's Profiling integrations." --- diff --git a/docs/platforms/javascript/guides/react-router/profiling/index.mdx b/docs/platforms/javascript/guides/react-router/profiling/index.mdx index 358ff175b7055..7521daa475de0 100644 --- a/docs/platforms/javascript/guides/react-router/profiling/index.mdx +++ b/docs/platforms/javascript/guides/react-router/profiling/index.mdx @@ -1,7 +1,7 @@ --- title: Set Up Profiling sidebar_title: Profiling -sidebar_order: 5000 +sidebar_order: 12 description: "Collect & view performance insights for JavaScript programs with Sentry's Profiling integrations." --- diff --git a/docs/platforms/javascript/guides/remix/profiling/index.mdx b/docs/platforms/javascript/guides/remix/profiling/index.mdx index 358ff175b7055..7521daa475de0 100644 --- a/docs/platforms/javascript/guides/remix/profiling/index.mdx +++ b/docs/platforms/javascript/guides/remix/profiling/index.mdx @@ -1,7 +1,7 @@ --- title: Set Up Profiling sidebar_title: Profiling -sidebar_order: 5000 +sidebar_order: 12 description: "Collect & view performance insights for JavaScript programs with Sentry's Profiling integrations." --- diff --git a/docs/platforms/javascript/guides/solidstart/profiling/index.mdx b/docs/platforms/javascript/guides/solidstart/profiling/index.mdx index 358ff175b7055..7521daa475de0 100644 --- a/docs/platforms/javascript/guides/solidstart/profiling/index.mdx +++ b/docs/platforms/javascript/guides/solidstart/profiling/index.mdx @@ -1,7 +1,7 @@ --- title: Set Up Profiling sidebar_title: Profiling -sidebar_order: 5000 +sidebar_order: 12 description: "Collect & view performance insights for JavaScript programs with Sentry's Profiling integrations." --- diff --git a/docs/platforms/javascript/guides/sveltekit/profiling/index.mdx b/docs/platforms/javascript/guides/sveltekit/profiling/index.mdx index 358ff175b7055..7521daa475de0 100644 --- a/docs/platforms/javascript/guides/sveltekit/profiling/index.mdx +++ b/docs/platforms/javascript/guides/sveltekit/profiling/index.mdx @@ -1,7 +1,7 @@ --- title: Set Up Profiling sidebar_title: Profiling -sidebar_order: 5000 +sidebar_order: 12 description: "Collect & view performance insights for JavaScript programs with Sentry's Profiling integrations." --- diff --git a/docs/platforms/javascript/guides/tanstackstart-react/profiling/index.mdx b/docs/platforms/javascript/guides/tanstackstart-react/profiling/index.mdx index 358ff175b7055..7521daa475de0 100644 --- a/docs/platforms/javascript/guides/tanstackstart-react/profiling/index.mdx +++ b/docs/platforms/javascript/guides/tanstackstart-react/profiling/index.mdx @@ -1,7 +1,7 @@ --- title: Set Up Profiling sidebar_title: Profiling -sidebar_order: 5000 +sidebar_order: 12 description: "Collect & view performance insights for JavaScript programs with Sentry's Profiling integrations." --- diff --git a/src/components/splitLayout/style.module.scss b/src/components/splitLayout/style.module.scss index fd2cbcb6dd009..11a2d4d35f55b 100644 --- a/src/components/splitLayout/style.module.scss +++ b/src/components/splitLayout/style.module.scss @@ -69,12 +69,17 @@ position: sticky; top: calc(var(--header-height, 80px) + 1rem); min-width: 0; // Allow flex item to shrink below content size - overflow: hidden; // Prevent content from expanding the column + max-height: calc(100vh - var(--header-height, 80px) - 4rem); + overflow-y: auto; // Allow vertical scrolling for long code + overflow-x: hidden; // Prevent horizontal overflow since we're wrapping + padding-bottom: 1rem; // Ensure bottom content isn't cut off @media (max-width: 1024px) { position: relative; top: auto; + max-height: none; overflow: visible; + padding-bottom: 0; } // Ensure code blocks fill the space From 0f20a12e7c87893b174acd77dc4ef744f6a1de9d Mon Sep 17 00:00:00 2001 From: Cody De Arkland Date: Mon, 10 Nov 2025 18:24:02 -0800 Subject: [PATCH 05/23] Improve code snippet word wrapping in SplitLayout --- src/components/splitLayout/style.module.scss | 13 +++++++++++-- 1 file changed, 11 insertions(+), 2 deletions(-) diff --git a/src/components/splitLayout/style.module.scss b/src/components/splitLayout/style.module.scss index 11a2d4d35f55b..e801c56f58a45 100644 --- a/src/components/splitLayout/style.module.scss +++ b/src/components/splitLayout/style.module.scss @@ -71,7 +71,7 @@ min-width: 0; // Allow flex item to shrink below content size max-height: calc(100vh - var(--header-height, 80px) - 4rem); overflow-y: auto; // Allow vertical scrolling for long code - overflow-x: hidden; // Prevent horizontal overflow since we're wrapping + overflow-x: auto; // Allow horizontal scrolling as fallback if wrapping fails padding-bottom: 1rem; // Ensure bottom content isn't cut off @media (max-width: 1024px) { @@ -98,7 +98,8 @@ white-space: pre-wrap !important; word-wrap: break-word !important; overflow-wrap: break-word !important; - overflow-x: visible !important; + overflow-x: auto !important; + max-width: 100% !important; } :global(code), @@ -106,6 +107,7 @@ white-space: pre-wrap !important; word-wrap: break-word !important; overflow-wrap: break-word !important; + max-width: 100% !important; } :global(.code-line) { @@ -113,5 +115,12 @@ word-wrap: break-word !important; overflow-wrap: break-word !important; } + + // Also target any nested divs that might contain code + :global(div[class*='code']), + :global(div[class*='highlight']) { + overflow-x: auto !important; + max-width: 100% !important; + } } From 3fd63a2f2d298fe358fdd9d30ea0788f875058a9 Mon Sep 17 00:00:00 2001 From: Cody De Arkland Date: Mon, 10 Nov 2025 18:25:32 -0800 Subject: [PATCH 06/23] Strengthen word wrap overrides with more specific selectors --- src/components/splitLayout/style.module.scss | 25 +++++++++++++++----- 1 file changed, 19 insertions(+), 6 deletions(-) diff --git a/src/components/splitLayout/style.module.scss b/src/components/splitLayout/style.module.scss index e801c56f58a45..54f7caf6922ee 100644 --- a/src/components/splitLayout/style.module.scss +++ b/src/components/splitLayout/style.module.scss @@ -92,34 +92,47 @@ } // Override global code block styles to enable wrapping - // Use !important to ensure these override the global styles + // Target all possible code elements with maximum specificity :global(pre), - :global(pre[class*='language-']) { + :global(pre[class*='language-']), + :global(.code-block) :global(pre), + :global(.code-block) :global(pre[class*='language-']) { white-space: pre-wrap !important; word-wrap: break-word !important; overflow-wrap: break-word !important; - overflow-x: auto !important; + overflow-x: visible !important; max-width: 100% !important; } :global(code), - :global(code[class*='language-']) { + :global(code[class*='language-']), + :global(.code-block) :global(code), + :global(.code-block) :global(code[class*='language-']) { white-space: pre-wrap !important; word-wrap: break-word !important; overflow-wrap: break-word !important; max-width: 100% !important; } - :global(.code-line) { + :global(.code-line), + :global(.code-block) :global(.code-line) { white-space: pre-wrap !important; word-wrap: break-word !important; overflow-wrap: break-word !important; + float: none !important; + min-width: 0 !important; + } + + // Target the code highlight wrapper + :global(.code-highlight) { + float: none !important; + min-width: 0 !important; } // Also target any nested divs that might contain code :global(div[class*='code']), :global(div[class*='highlight']) { - overflow-x: auto !important; + overflow-x: visible !important; max-width: 100% !important; } } From 2cd5009f0ec1ff299f281bdddfdb5e7844b08b95 Mon Sep 17 00:00:00 2001 From: Cody De Arkland Date: Mon, 10 Nov 2025 21:16:46 -0800 Subject: [PATCH 07/23] Adding beta tag to opentelemetry support --- docs/platforms/javascript/common/opentelemetry/index.mdx | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/platforms/javascript/common/opentelemetry/index.mdx b/docs/platforms/javascript/common/opentelemetry/index.mdx index 6044f1c3ce6d6..973049a90881c 100644 --- a/docs/platforms/javascript/common/opentelemetry/index.mdx +++ b/docs/platforms/javascript/common/opentelemetry/index.mdx @@ -25,6 +25,7 @@ supported: - javascript.tanstackstart-react notSupported: - javascript +beta: true --- The Sentry SDK uses [OpenTelemetry](https://opentelemetry.io/) under the hood. This means that any OpenTelemetry instrumentation that emits spans will automatically be picked up by Sentry without any further configuration. From c0d5abfbc72bc7ac2c413d9237110767219cd5b7 Mon Sep 17 00:00:00 2001 From: Cody De Arkland Date: Tue, 11 Nov 2025 08:54:40 -0800 Subject: [PATCH 08/23] Style fixes for sticky header --- src/components/splitLayout/style.module.scss | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/src/components/splitLayout/style.module.scss b/src/components/splitLayout/style.module.scss index 54f7caf6922ee..4b5d8e18be3ec 100644 --- a/src/components/splitLayout/style.module.scss +++ b/src/components/splitLayout/style.module.scss @@ -67,9 +67,9 @@ .splitCode { position: sticky; - top: calc(var(--header-height, 80px) + 1rem); + top: calc(var(--header-height, 80px) + 3.25rem); min-width: 0; // Allow flex item to shrink below content size - max-height: calc(100vh - var(--header-height, 80px) - 4rem); + max-height: calc(100vh - var(--header-height, 80px) - 6.5rem); overflow-y: auto; // Allow vertical scrolling for long code overflow-x: auto; // Allow horizontal scrolling as fallback if wrapping fails padding-bottom: 1rem; // Ensure bottom content isn't cut off From 7c81a05e061e678395cc227659b8d8f712fa2bab Mon Sep 17 00:00:00 2001 From: Cody De Arkland Date: Tue, 11 Nov 2025 08:54:49 -0800 Subject: [PATCH 09/23] Removing accidental content additions --- .../javascript/guides/nextjs/index.mdx | 22 ------------------- 1 file changed, 22 deletions(-) diff --git a/docs/platforms/javascript/guides/nextjs/index.mdx b/docs/platforms/javascript/guides/nextjs/index.mdx index 1136a6b128143..b8e42ac077c15 100644 --- a/docs/platforms/javascript/guides/nextjs/index.mdx +++ b/docs/platforms/javascript/guides/nextjs/index.mdx @@ -81,17 +81,6 @@ The wizard creates a client configuration file that initializes the Sentry SDK i The configuration includes your DSN (Data Source Name), which connects your app to your Sentry project, and enables the features you selected during installation. -Key configuration options: - -- **`sendDefaultPii`** - Adds request headers and user IP for better debugging -- **`integrations`** - Enables features like Session Replay and User Feedback -- **`enableLogs`** - Forwards console logs to Sentry -- **`tracesSampleRate`** - Controls performance monitoring sampling (1.0 = 100%) -- **`replaysSessionSampleRate`** - Captures 10% of all sessions -- **`replaysOnErrorSampleRate`** - Captures 100% of sessions with errors - -The `onRouterTransitionStart` export enables automatic performance tracking for Next.js page transitions. - @@ -156,17 +145,6 @@ export const onRouterTransitionStart = Sentry.captureRouterTransitionStart; The wizard also creates a server configuration file for Node.js and Edge runtimes. -This configuration captures errors from: -- API routes -- Server components -- Server actions -- Middleware -- Edge functions - -The server configuration is simpler than the client configuration because some features (like Session Replay and User Feedback) are client-only. - -**Note:** Make sure `sendDefaultPii` is set to `true` if you want to capture user context with server-side errors. - For more advanced configuration options or to set up Sentry manually, check out our [manual setup guide](/platforms/javascript/guides/nextjs/manual-setup/). From 99759bb7326d3cf8b9d4be91076b03def6d502f9 Mon Sep 17 00:00:00 2001 From: Cody De Arkland Date: Tue, 11 Nov 2025 08:55:02 -0800 Subject: [PATCH 10/23] duplicating pill config from prod --- src/components/sidebar/style.module.scss | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/src/components/sidebar/style.module.scss b/src/components/sidebar/style.module.scss index 38ecb43258964..34835dc0584d5 100644 --- a/src/components/sidebar/style.module.scss +++ b/src/components/sidebar/style.module.scss @@ -169,11 +169,11 @@ align-items: center; padding: 0.0625rem 0.375rem; font-size: 0.625rem; - font-weight: 500; - letter-spacing: 0.02em; + font-weight: 600; + letter-spacing: 0.08em; color: #fafaf9; /* off-white */ background-color: transparent; - border: 1px solid #f59e0b; /* amber-500 warning color */ + border: 2px solid #f59e0b; /* amber-500 warning color */ border-radius: 0.25rem; white-space: nowrap; flex-shrink: 0; @@ -189,11 +189,11 @@ align-items: center; padding: 0.0625rem 0.375rem; font-size: 0.625rem; - font-weight: 500; - letter-spacing: 0.02em; + font-weight: 600; + letter-spacing: 0.08em; color: #fafaf9; /* off-white */ background-color: transparent; - border: 1px solid #10b981; /* emerald-500 success green */ + border: 2px solid #10b981; /* emerald-500 success green */ border-radius: 0.25rem; white-space: nowrap; flex-shrink: 0; From 93ae024abfa0a257b56be2ca7ec5e96a96c0eb7a Mon Sep 17 00:00:00 2001 From: Cody De Arkland Date: Tue, 11 Nov 2025 09:01:04 -0800 Subject: [PATCH 11/23] Correcting redirects --- redirects.js | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/redirects.js b/redirects.js index 37dae48fbd1f2..0887a23ded05b 100644 --- a/redirects.js +++ b/redirects.js @@ -529,23 +529,23 @@ const userDocsRedirects = [ }, { source: '/platforms/javascript/configuration/draining/', - destination: '/platforms/javascript/apis/#flush', + destination: '/platforms/javascript/configuration/apis/#flush', }, { source: '/platforms/javascript/guides/:guide/configuration/draining/', - destination: '/platforms/javascript/guides/:guide/apis/#flush', + destination: '/platforms/javascript/guides/:guide/configuration/apis/#flush', }, { source: '/platforms/javascript/enriching-events/identify-user/', - destination: '/platforms/javascript/apis/#setUser', + destination: '/platforms/javascript/configuration/apis/#setUser', }, { source: '/platforms/javascript/guides/:guide/enriching-events/identify-user/', - destination: '/platforms/javascript/guides/:guide/apis/#setUser', + destination: '/platforms/javascript/guides/:guide/configuration/apis/#setUser', }, { source: '/platforms/javascript/enriching-events/context/', - destination: '/platforms/javascript/apis/', + destination: '/platforms/javascript/configuration/apis/', }, { source: '/platforms/javascript/guides/:guide/enriching-events/context/', From 3ded19356a821d680bccbd13ab2941f3045fb838 Mon Sep 17 00:00:00 2001 From: Cody De Arkland Date: Tue, 11 Nov 2025 21:17:01 -0800 Subject: [PATCH 12/23] Style fixes to correct width / overlap issues --- src/components/docPage/index.tsx | 14 ++++++++++---- 1 file changed, 10 insertions(+), 4 deletions(-) diff --git a/src/components/docPage/index.tsx b/src/components/docPage/index.tsx index 51e1c7fb995da..58366bef8bf6b 100644 --- a/src/components/docPage/index.tsx +++ b/src/components/docPage/index.tsx @@ -67,10 +67,10 @@ export function DocPage({ {sidebar ?? ( )} -
+
)} - +