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 0c22a8482fc8b7..dd8d5d51dcc8cb 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 88bb3498add9e5..7db54b4633ff37 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 1b551ce15b7467..37dae48fbd1f2b 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 50022148b33564..d4c88ad361778c 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 5e5583a4b6a0b9..7883c56718dc2f 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 2f0a0749385ac2..c5e349f8d31a51 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 5761afcadeb795..e5f17178389eaf 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 a62e57d704dceb..dc9d13c16293e7 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 dc9d13c16293e7..74e5d860aa7b11 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 d8727d026c0fd7..4527535b66afa4 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 ff505660535760..6bda59dc6db7e0 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 050223cad6110e..e1c3c9a01d5764 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 d003e03e02df80..f1b7163c26571e 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 d4c88ad361778c..58739cc214fe90 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 7883c56718dc2f..d0fb85ff619425 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 83e98b38e24c60..6044f1c3ce6d63 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 a04da12b821ae1..22e4c05438f5f7 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 7db54b4633ff37..848c2e55499c84 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 c5e349f8d31a51..ae713a1867a48b 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 0a67387ae019bb..f7f96a759b9b72 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 e5f17178389eaf..8b62ee2bd86fc1 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 d402ccad46bb83..04026f151fae64 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 033750ca59a148..bfc828b7eff19e 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 358ff175b7055b..7521daa475de01 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 358ff175b7055b..7521daa475de01 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 3306adfe15844f..1136a6b1281438 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 358ff175b7055b..7521daa475de01 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 358ff175b7055b..7521daa475de01 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 358ff175b7055b..7521daa475de01 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 358ff175b7055b..7521daa475de01 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 358ff175b7055b..7521daa475de01 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 358ff175b7055b..7521daa475de01 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 358ff175b7055b..7521daa475de01 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 fd2cbcb6dd009e..11a2d4d35f55b1 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 11a2d4d35f55b1..e801c56f58a45e 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 e801c56f58a45e..54f7caf6922ee1 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 6044f1c3ce6d63..973049a90881cf 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 54f7caf6922ee1..4b5d8e18be3ec6 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 1136a6b1281438..b8e42ac077c150 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 38ecb43258964d..34835dc0584d5f 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 37dae48fbd1f2b..0887a23ded05b1 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 51e1c7fb995dab..58366bef8bf6b7 100644 --- a/src/components/docPage/index.tsx +++ b/src/components/docPage/index.tsx @@ -67,10 +67,10 @@ export function DocPage({ {sidebar ?? ( )} -
+
)} - +