diff --git a/docs/platforms/react-native/build-distribution/index.mdx b/docs/platforms/react-native/build-distribution/index.mdx
index 931e8ac9cdd3ab..a40e7c747a3c98 100644
--- a/docs/platforms/react-native/build-distribution/index.mdx
+++ b/docs/platforms/react-native/build-distribution/index.mdx
@@ -1,7 +1,8 @@
---
title: Build Distribution
sidebar_title: Build Distribution
-sidebar_order: 5250
+sidebar_order: 10
+sidebar_section: configuration
description: Upload React Native iOS and Android builds to Sentry for distribution to internal teams and beta testers.
---
diff --git a/docs/platforms/react-native/configuration/index.mdx b/docs/platforms/react-native/configuration/index.mdx
index cff67a5bf5f5ce..45760dcff55d2a 100644
--- a/docs/platforms/react-native/configuration/index.mdx
+++ b/docs/platforms/react-native/configuration/index.mdx
@@ -1,7 +1,9 @@
---
-title: Configuration
+title: Extended Configuration
+sidebar_title: Extended Configuration
description: "Additional configuration options for the SDK."
-sidebar_order: 5
+sidebar_order: 2
+sidebar_section: configuration
---
diff --git a/docs/platforms/react-native/data-management/index.mdx b/docs/platforms/react-native/data-management/index.mdx
index a55334f82643be..8c09c556b69625 100644
--- a/docs/platforms/react-native/data-management/index.mdx
+++ b/docs/platforms/react-native/data-management/index.mdx
@@ -1,7 +1,8 @@
---
title: Data Management
description: Manage your events by pre-filtering, scrubbing sensitive information, and forwarding them to other systems.
-sidebar_order: 2500
+sidebar_order: 4
+sidebar_section: configuration
---
diff --git a/docs/platforms/react-native/enriching-events/index.mdx b/docs/platforms/react-native/enriching-events/index.mdx
index b7f2c5a94bfdb1..2826ce63efabbb 100644
--- a/docs/platforms/react-native/enriching-events/index.mdx
+++ b/docs/platforms/react-native/enriching-events/index.mdx
@@ -1,7 +1,8 @@
---
title: Enriching Events
description: Enrich events with additional context to make debugging simpler.
-sidebar_order: 2300
+sidebar_order: 1
+sidebar_section: configuration
---
diff --git a/docs/platforms/react-native/feature-flags/index.mdx b/docs/platforms/react-native/feature-flags/index.mdx
index 1ebe0c019e3387..1aa73129b98607 100644
--- a/docs/platforms/react-native/feature-flags/index.mdx
+++ b/docs/platforms/react-native/feature-flags/index.mdx
@@ -1,7 +1,8 @@
---
title: Set Up Feature Flags
sidebar_title: Feature Flags
-sidebar_order: 7000
+sidebar_order: 11
+sidebar_section: features
description: Generic Feature Flags Integration.
---
diff --git a/docs/platforms/react-native/features/index.mdx b/docs/platforms/react-native/features/index.mdx
index 87d72a92a83049..cb37d0fc1537f5 100644
--- a/docs/platforms/react-native/features/index.mdx
+++ b/docs/platforms/react-native/features/index.mdx
@@ -1,6 +1,7 @@
---
title: Features
sidebar_order: 1
+sidebar_hidden: true
description: "Learn about the features of Sentry's React Native SDK."
---
diff --git a/docs/platforms/react-native/integrations/index.mdx b/docs/platforms/react-native/integrations/index.mdx
index fb99c541a0f7bc..af9fc9dd301580 100644
--- a/docs/platforms/react-native/integrations/index.mdx
+++ b/docs/platforms/react-native/integrations/index.mdx
@@ -1,7 +1,8 @@
---
title: Integrations
description: "Learn more about how integrations extend the functionality of our SDK and automatically cover common libraries and environments."
-sidebar_order: 30
+sidebar_order: 3
+sidebar_section: configuration
---
diff --git a/docs/platforms/react-native/logs/index.mdx b/docs/platforms/react-native/logs/index.mdx
index 887417ebe5f2c3..3e17e47f59a440 100644
--- a/docs/platforms/react-native/logs/index.mdx
+++ b/docs/platforms/react-native/logs/index.mdx
@@ -2,7 +2,9 @@
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: 4
+sidebar_section: features
+new: true
---
diff --git a/docs/platforms/react-native/metrics/index.mdx b/docs/platforms/react-native/metrics/index.mdx
index a3c01f855502bb..c45e3ec02bfe58 100644
--- a/docs/platforms/react-native/metrics/index.mdx
+++ b/docs/platforms/react-native/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: 5760
+sidebar_order: 6
+sidebar_section: features
beta: true
---
diff --git a/docs/platforms/react-native/migration/index.mdx b/docs/platforms/react-native/migration/index.mdx
index a566495c6b3719..9108d8b9ccfc41 100644
--- a/docs/platforms/react-native/migration/index.mdx
+++ b/docs/platforms/react-native/migration/index.mdx
@@ -1,6 +1,7 @@
---
title: Migration Guide
-sidebar_order: 8000
+sidebar_order: 11
+sidebar_section: configuration
description: "Learn how to migrate to the new versions of Sentry's React Native SDK."
---
diff --git a/docs/platforms/react-native/overhead/index.mdx b/docs/platforms/react-native/overhead/index.mdx
index 86dbcc85981a9a..2d32b342ab45c4 100644
--- a/docs/platforms/react-native/overhead/index.mdx
+++ b/docs/platforms/react-native/overhead/index.mdx
@@ -1,7 +1,8 @@
---
title: SDK Overhead
description: "Learn about Sentry's React Native SDK overhead and how you can tailor your configuration to minimize it."
-sidebar_order: 7500
+sidebar_order: 9
+sidebar_section: configuration
---
Adding new features or dependencies to your app incurs additional costs on resources - CPU time, memory usage, and network bandwidth, among other things. Sentry SDKs are no different. This document adds transparency to the possible overhead that using our SDK can add, and help you find the feature set and configurations that work best for you.
diff --git a/docs/platforms/react-native/profiling/index.mdx b/docs/platforms/react-native/profiling/index.mdx
index aae61d74684bea..6c61a6e30370af 100644
--- a/docs/platforms/react-native/profiling/index.mdx
+++ b/docs/platforms/react-native/profiling/index.mdx
@@ -2,7 +2,8 @@
title: Set Up Profiling
sidebar_title: Profiling
description: "Learn how to enable profiling in your app if it is not already set up."
-sidebar_order: 5000
+sidebar_order: 3
+sidebar_section: features
---
diff --git a/docs/platforms/react-native/releases/index.mdx b/docs/platforms/react-native/releases/index.mdx
index b3f34c76a39b43..ad7e2d62ebab68 100644
--- a/docs/platforms/react-native/releases/index.mdx
+++ b/docs/platforms/react-native/releases/index.mdx
@@ -1,7 +1,8 @@
---
title: Mobile SDK Releases
description: "Learn about Sentry's release channels for Mobile SDK updates."
-sidebar_order: 7000
+sidebar_order: 8
+sidebar_section: configuration
---
The React Native SDK uses the following channels to release SDK updates:
diff --git a/docs/platforms/react-native/session-replay/index.mdx b/docs/platforms/react-native/session-replay/index.mdx
index e869393a324175..2190364db42052 100644
--- a/docs/platforms/react-native/session-replay/index.mdx
+++ b/docs/platforms/react-native/session-replay/index.mdx
@@ -1,7 +1,8 @@
---
title: Set Up Session Replay
sidebar_title: Session Replay
-sidebar_order: 5500
+sidebar_order: 5
+sidebar_section: features
notSupported:
description: "Learn how to enable Session Replay in your mobile app."
---
diff --git a/docs/platforms/react-native/size-analysis/index.mdx b/docs/platforms/react-native/size-analysis/index.mdx
index 58550c14febebc..f93a3ad8cf0d5a 100644
--- a/docs/platforms/react-native/size-analysis/index.mdx
+++ b/docs/platforms/react-native/size-analysis/index.mdx
@@ -1,7 +1,8 @@
---
title: Size Analysis
sidebar_title: Size Analysis
-sidebar_order: 5200
+sidebar_order: 12
+sidebar_section: features
description: Upload React Native iOS and Android builds to Sentry for size analysis.
---
diff --git a/docs/platforms/react-native/sourcemaps/index.mdx b/docs/platforms/react-native/sourcemaps/index.mdx
index c92750929fd18f..9328ea9b872a58 100644
--- a/docs/platforms/react-native/sourcemaps/index.mdx
+++ b/docs/platforms/react-native/sourcemaps/index.mdx
@@ -1,7 +1,8 @@
---
title: Source Maps
description: "Learn more about how to upload your source maps to Sentry."
-sidebar_order: 95
+sidebar_order: 5
+sidebar_section: configuration
---
diff --git a/docs/platforms/react-native/tracing/index.mdx b/docs/platforms/react-native/tracing/index.mdx
index 6c6cd7b0d70086..af86e2a5fee71a 100644
--- a/docs/platforms/react-native/tracing/index.mdx
+++ b/docs/platforms/react-native/tracing/index.mdx
@@ -2,7 +2,8 @@
title: Set Up Tracing
sidebar_title: Tracing
description: "Learn how to enable tracing in your app and discover valuable performance insights of your application."
-sidebar_order: 4000
+sidebar_order: 2
+sidebar_section: features
---
With [tracing](/product/insights/overview/), Sentry tracks your software performance, measuring metrics like throughput and latency, and displaying the impact of errors across multiple systems. Sentry captures distributed traces consisting of transactions and spans, which measure individual services and individual operations within those services. Learn more about our model in [Distributed Tracing](/product/sentry-basics/tracing/distributed-tracing/).
diff --git a/docs/platforms/react-native/troubleshooting/index.mdx b/docs/platforms/react-native/troubleshooting/index.mdx
index b8b5152e1166f0..da86a37221898d 100644
--- a/docs/platforms/react-native/troubleshooting/index.mdx
+++ b/docs/platforms/react-native/troubleshooting/index.mdx
@@ -1,7 +1,8 @@
---
title: Troubleshooting
description: "Troubleshoot and resolve common issues with the React Native SDK."
-sidebar_order: 9000
+sidebar_order: 12
+sidebar_section: configuration
---
## Support 16 KB Page Sizes on Android
diff --git a/docs/platforms/react-native/upload-debug/index.mdx b/docs/platforms/react-native/upload-debug/index.mdx
index 9c0fe032445f01..fbbf99f9ffbc8e 100644
--- a/docs/platforms/react-native/upload-debug/index.mdx
+++ b/docs/platforms/react-native/upload-debug/index.mdx
@@ -1,6 +1,7 @@
---
title: Debug Symbols
-sidebar_order: 96
+sidebar_order: 7
+sidebar_section: configuration
description: "Learn about using the Sentry Gradle Plugin or sentry-cli for providing debug symbols to Sentry."
---
diff --git a/docs/platforms/react-native/usage/index.mdx b/docs/platforms/react-native/usage/index.mdx
index 9ac2b8c9c6b0bf..d4bdf572cada0b 100644
--- a/docs/platforms/react-native/usage/index.mdx
+++ b/docs/platforms/react-native/usage/index.mdx
@@ -1,7 +1,8 @@
---
-title: Usage
+title: Capturing Errors
description: "Use the SDK to manually capture errors and other events."
-sidebar_order: 10
+sidebar_order: 1
+sidebar_section: features
---
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/react-native/user-feedback/index.mdx b/docs/platforms/react-native/user-feedback/index.mdx
index 67b176729fc4b8..e17f9082ccbd6d 100644
--- a/docs/platforms/react-native/user-feedback/index.mdx
+++ b/docs/platforms/react-native/user-feedback/index.mdx
@@ -2,7 +2,8 @@
title: Set Up User Feedback
sidebar_title: User Feedback
description: Learn how to enable User Feedback in your app.
-sidebar_order: 6000
+sidebar_order: 10
+sidebar_section: features
og_image: /og-images/platforms-react-native-user-feedback.png
---
diff --git a/src/components/sidebar/dynamicNav.tsx b/src/components/sidebar/dynamicNav.tsx
index c4bd14ada386c2..f99c10766c765d 100644
--- a/src/components/sidebar/dynamicNav.tsx
+++ b/src/components/sidebar/dynamicNav.tsx
@@ -1,4 +1,5 @@
import {Fragment} from 'react';
+import Link from 'next/link';
import {serverContext} from 'sentry-docs/serverContext';
import {sortPages} from 'sentry-docs/utils';
@@ -13,6 +14,11 @@ const SECTION_LABELS: Record = {
configuration: 'Configuration',
};
+// Section links configuration - sections that should be clickable headers
+const SECTION_LINKS: Record = {
+ features: 'features',
+};
+
const SECTION_ORDER = ['features', 'configuration'] as const;
type Node = {
@@ -73,7 +79,8 @@ export const renderChildren = (
exclude: string[],
path: string,
showDepth: number = 0,
- depth: number = 0
+ depth: number = 0,
+ rootPath?: string
): React.ReactNode[] => {
const sortedChildren = sortPages(
children.filter(
@@ -124,7 +131,7 @@ export const renderChildren = (
beta={node.context.beta}
isNew={node.context.new}
>
- {renderChildren(nodeChildren, exclude, path, showDepth, depth + 1)}
+ {renderChildren(nodeChildren, exclude, path, showDepth, depth + 1, rootPath)}
);
@@ -146,13 +153,22 @@ export const renderChildren = (
result.push();
}
- // Add section header
+ // Add section header (with optional link)
+ const sectionLink = SECTION_LINKS[sectionKey];
+ const sectionHref = sectionLink && rootPath ? `/${rootPath}/${sectionLink}/` : null;
+
result.push(