getsentry · smeubank · Mar 18, 2025 · Mar 11, 2025 · Mar 11, 2025 · Mar 11, 2025
diff --git a/...forms/dart/configuration/environments.mdx → ...art/common/configuration/environments.mdx b/...forms/dart/configuration/environments.mdx → ...art/common/configuration/environments.mdx
diff --git a/...latforms/dart/configuration/filtering.mdx → ...s/dart/common/configuration/filtering.mdx b/...latforms/dart/configuration/filtering.mdx → ...s/dart/common/configuration/filtering.mdx
diff --git a/docs/platforms/dart/configuration/index.mdx → ...forms/dart/common/configuration/index.mdx b/docs/platforms/dart/configuration/index.mdx → ...forms/dart/common/configuration/index.mdx
@@ -1,7 +1,7 @@
 ---
 title: Configuration
 description: "Additional configuration options for the SDK."
-sidebar_order: 5
+sidebar_order: 4
 ---
 
 <PageGrid />
diff --git a/.../platforms/dart/configuration/options.mdx → ...rms/dart/common/configuration/options.mdx b/.../platforms/dart/configuration/options.mdx → ...rms/dart/common/configuration/options.mdx
diff --git a/...platforms/dart/configuration/releases.mdx → ...ms/dart/common/configuration/releases.mdx b/...platforms/dart/configuration/releases.mdx → ...ms/dart/common/configuration/releases.mdx
diff --git a/...platforms/dart/configuration/sampling.mdx → ...ms/dart/common/configuration/sampling.mdx b/...platforms/dart/configuration/sampling.mdx → ...ms/dart/common/configuration/sampling.mdx
diff --git a/...s/dart/data-management/data-collected.mdx → ...common/data-management/data-collected.mdx b/...s/dart/data-management/data-collected.mdx → ...common/data-management/data-collected.mdx
diff --git a/.../platforms/dart/data-management/index.mdx → ...rms/dart/common/data-management/index.mdx b/.../platforms/dart/data-management/index.mdx → ...rms/dart/common/data-management/index.mdx
diff --git a/.../data-management/sensitive-data/index.mdx → .../data-management/sensitive-data/index.mdx b/.../data-management/sensitive-data/index.mdx → .../data-management/sensitive-data/index.mdx
diff --git a/docs/platforms/dart/common/debug-symbols/dart-plugin.mdx b/docs/platforms/dart/common/debug-symbols/dart-plugin.mdx
@@ -0,0 +1,9 @@
+---
+title: Sentry Dart Plugin
+description: "Learn how to use the Sentry Dart Plugin to automatically upload debug symbols for your Dart application."
+sidebar_order: 1
+---
+
+The [Sentry Dart Plugin](https://github.com/getsentry/sentry-dart-plugin) is the recommended way to upload debug symbols for Dart applications. It automates the upload process for Android, iOS, macOS, and Web, making it seamless to provide Sentry with the necessary files for symbolication.
+
+<PlatformContent includePath="debug-symbols/dart-plugin" /> 
diff --git a/docs/platforms/dart/common/debug-symbols/index.mdx b/docs/platforms/dart/common/debug-symbols/index.mdx
@@ -0,0 +1,37 @@
+---
+title: Debug Symbols
+description: "Learn about uploading debug symbols to enable symbolication of stack traces in your Dart applications."
+sidebar_order: 3
+---
+
+Debug symbols are essential for understanding stack traces in your Dart application when errors occur. Without debug symbols, stack traces from minified or obfuscated code can be difficult or impossible to interpret.
+
+## What Are Debug Symbols?
+
+Debug symbols provide the necessary information to convert program addresses back to function names, source file names, and line numbers. When you build a Dart application, especially with obfuscation or optimization enabled, this information is typically removed from the main application bundle to reduce size.
+
+In Dart applications, debug symbols can include:
+
+- **For Dart code**: Symbol files generated when using `--split-debug-info` and `--obfuscate` flags
+- **For iOS/macOS**: dSYM files
+- **For Android**: Proguard/R8 mapping files and symbols files
+- **For Flutter Web**: Source maps
+- **For Android NDK**: ELF DWARF debug files
+
+## When to Upload Debug Symbols
+
+With default settings, complete stack traces are available in your Dart errors out of the box, unless you use [`split-debug-info`](https://flutter.dev/docs/perf/app-size#reducing-app-size) and [`obfuscate`](https://flutter.dev/docs/deployment/obfuscate) flags. In these cases, you must upload the debug information files generated by the build, so Sentry can show proper stack traces.
+
+## Upload Methods
+
+Sentry offers several methods to upload debug symbols for Dart applications:
+
+1. **[Sentry Dart Plugin (Recommended)](/platforms/dart/debug-symbols/dart-plugin)** - The easiest way to automatically upload debug symbols for iOS, Android, Desktop and Web.
+
+2. **[Manual Upload Options](/platforms/dart/debug-symbols/manual-upload):**
+   - [iOS and macOS](/platforms/apple/dsym/) - Upload dSYM files for symbolication of Apple platform crashes.
+   - [Android](/cli/dif/#uploading-files) - Upload mapping files manually using the Sentry CLI.
+   - [Android NDK](/cli/dif/#uploading-files) - Upload ELF DWARF debug files for native code crashes.
+   - [Web](/cli/releases/#upload-source-maps) - Upload source maps for Flutter web applications.
+
+Choose the method that best suits your workflow and platform requirements. For most users, the Sentry Dart Plugin provides the simplest solution across all platforms. 
diff --git a/docs/platforms/dart/common/debug-symbols/manual-upload.mdx b/docs/platforms/dart/common/debug-symbols/manual-upload.mdx
@@ -0,0 +1,9 @@
+---
+title: Manual Upload
+description: "Learn how to manually upload debug symbols for your Dart applications."
+sidebar_order: 2
+---
+
+If you choose not to use the Sentry Dart Plugin, you can manually upload debug symbols for your Dart applications. This page provides instructions for different platforms.
+
+<PlatformContent includePath="debug-symbols/manual-upload" /> 
diff --git a/...rt/enriching-events/attachments/index.mdx → ...on/enriching-events/attachments/index.mdx b/...rt/enriching-events/attachments/index.mdx → ...on/enriching-events/attachments/index.mdx
diff --git a/...rt/enriching-events/breadcrumbs/index.mdx → ...on/enriching-events/breadcrumbs/index.mdx b/...rt/enriching-events/breadcrumbs/index.mdx → ...on/enriching-events/breadcrumbs/index.mdx
diff --git a/...s/dart/enriching-events/context/index.mdx → ...common/enriching-events/context/index.mdx b/...s/dart/enriching-events/context/index.mdx → ...common/enriching-events/context/index.mdx
diff --git a/.../enriching-events/identify-user/index.mdx → .../enriching-events/identify-user/index.mdx b/.../enriching-events/identify-user/index.mdx → .../enriching-events/identify-user/index.mdx
diff --git a/...platforms/dart/enriching-events/index.mdx → ...ms/dart/common/enriching-events/index.mdx b/...platforms/dart/enriching-events/index.mdx → ...ms/dart/common/enriching-events/index.mdx
diff --git a/...ms/dart/enriching-events/scopes/index.mdx → .../common/enriching-events/scopes/index.mdx b/...ms/dart/enriching-events/scopes/index.mdx → .../common/enriching-events/scopes/index.mdx
diff --git a/...orms/dart/enriching-events/tags/index.mdx → ...rt/common/enriching-events/tags/index.mdx b/...orms/dart/enriching-events/tags/index.mdx → ...rt/common/enriching-events/tags/index.mdx
diff --git a/...riching-events/transaction-name/index.mdx → ...riching-events/transaction-name/index.mdx b/...riching-events/transaction-name/index.mdx → ...riching-events/transaction-name/index.mdx
diff --git a/docs/platforms/dart/features/index.mdx → .../platforms/dart/common/features/index.mdx b/docs/platforms/dart/features/index.mdx → .../platforms/dart/common/features/index.mdx
diff --git a/docs/platforms/dart/index.mdx → docs/platforms/dart/common/index.mdx b/docs/platforms/dart/index.mdx → docs/platforms/dart/common/index.mdx
diff --git a/docs/platforms/dart/integrations/dio.mdx → ...latforms/dart/common/integrations/dio.mdx b/docs/platforms/dart/integrations/dio.mdx → ...latforms/dart/common/integrations/dio.mdx
diff --git a/docs/platforms/dart/integrations/file.mdx → ...atforms/dart/common/integrations/file.mdx b/docs/platforms/dart/integrations/file.mdx → ...atforms/dart/common/integrations/file.mdx
diff --git a/...ms/dart/integrations/http-integration.mdx → .../common/integrations/http-integration.mdx b/...ms/dart/integrations/http-integration.mdx → .../common/integrations/http-integration.mdx
diff --git a/docs/platforms/dart/integrations/index.mdx → ...tforms/dart/common/integrations/index.mdx b/docs/platforms/dart/integrations/index.mdx → ...tforms/dart/common/integrations/index.mdx
diff --git a/docs/platforms/dart/integrations/logging.mdx → ...orms/dart/common/integrations/logging.mdx b/docs/platforms/dart/integrations/logging.mdx → ...orms/dart/common/integrations/logging.mdx
diff --git a/docs/platforms/dart/metrics/index.mdx → docs/platforms/dart/common/metrics/index.mdx b/docs/platforms/dart/metrics/index.mdx → docs/platforms/dart/common/metrics/index.mdx
diff --git a/docs/platforms/dart/migration/index.mdx → ...platforms/dart/common/migration/index.mdx b/docs/platforms/dart/migration/index.mdx → ...platforms/dart/common/migration/index.mdx
diff --git a/docs/platforms/dart/overhead/index.mdx → .../platforms/dart/common/overhead/index.mdx b/docs/platforms/dart/overhead/index.mdx → .../platforms/dart/common/overhead/index.mdx
diff --git a/docs/platforms/dart/tracing/index.mdx → docs/platforms/dart/common/tracing/index.mdx b/docs/platforms/dart/tracing/index.mdx → docs/platforms/dart/common/tracing/index.mdx
diff --git a/...rumentation/automatic-instrumentation.mdx → ...rumentation/automatic-instrumentation.mdx b/...rumentation/automatic-instrumentation.mdx → ...rumentation/automatic-instrumentation.mdx
diff --git a/...nstrumentation/custom-instrumentation.mdx → ...nstrumentation/custom-instrumentation.mdx b/...nstrumentation/custom-instrumentation.mdx → ...nstrumentation/custom-instrumentation.mdx
diff --git a/...ms/dart/tracing/instrumentation/index.mdx → .../common/tracing/instrumentation/index.mdx b/...ms/dart/tracing/instrumentation/index.mdx → .../common/tracing/instrumentation/index.mdx
diff --git a/...g/instrumentation/performance-metrics.mdx → ...g/instrumentation/performance-metrics.mdx b/...g/instrumentation/performance-metrics.mdx → ...g/instrumentation/performance-metrics.mdx
diff --git a/...pagation/custom-instrumentation/index.mdx → ...pagation/custom-instrumentation/index.mdx b/...pagation/custom-instrumentation/index.mdx → ...pagation/custom-instrumentation/index.mdx
diff --git a/...gation/dealing-with-cors-issues/index.mdx → ...gation/dealing-with-cors-issues/index.mdx b/...gation/dealing-with-cors-issues/index.mdx → ...gation/dealing-with-cors-issues/index.mdx
diff --git a/.../dart/tracing/trace-propagation/index.mdx → ...ommon/tracing/trace-propagation/index.mdx b/.../dart/tracing/trace-propagation/index.mdx → ...ommon/tracing/trace-propagation/index.mdx
diff --git a/docs/platforms/dart/usage/index.mdx → docs/platforms/dart/common/usage/index.mdx b/docs/platforms/dart/usage/index.mdx → docs/platforms/dart/common/usage/index.mdx
diff --git a/...s/dart/usage/sdk-fingerprinting/index.mdx → ...common/usage/sdk-fingerprinting/index.mdx b/...s/dart/usage/sdk-fingerprinting/index.mdx → ...common/usage/sdk-fingerprinting/index.mdx
diff --git a/.../platforms/dart/usage/set-level/index.mdx → ...rms/dart/common/usage/set-level/index.mdx b/.../platforms/dart/usage/set-level/index.mdx → ...rms/dart/common/usage/set-level/index.mdx
diff --git a/docs/platforms/dart/user-feedback/index.mdx → ...forms/dart/common/user-feedback/index.mdx b/docs/platforms/dart/user-feedback/index.mdx → ...forms/dart/common/user-feedback/index.mdx
diff --git a/docs/platforms/dart/config.yml b/docs/platforms/dart/config.yml
@@ -0,0 +1,11 @@
+title: Dart
+caseStyle: camelCase
+supportLevel: production
+sdk: sentry.dart
+categories:
+  - desktop
+  - mobile
+  - server
+keywords:
+  - flutter
+  - dart
diff --git a/docs/platforms/dart/guides/flutter/debug-symbols/dart-plugin.mdx b/docs/platforms/dart/guides/flutter/debug-symbols/dart-plugin.mdx
@@ -0,0 +1,9 @@
+---
+title: Sentry Dart Plugin
+description: "Learn how to use the Sentry Dart Plugin to automatically upload debug symbols for your Dart application."
+sidebar_order: 1
+---
+
+The [Sentry Dart Plugin](https://github.com/getsentry/sentry-dart-plugin) is the recommended way to upload debug symbols for Dart applications. It automates the upload process for Android, iOS, macOS, and Web, making it seamless to provide Sentry with the necessary files for symbolication.
+
+<PlatformContent includePath="debug-symbols/dart-plugin" /> 
diff --git a/docs/platforms/dart/guides/flutter/debug-symbols/index.mdx b/docs/platforms/dart/guides/flutter/debug-symbols/index.mdx
@@ -0,0 +1,37 @@
+---
+title: Debug Symbols
+description: "Learn about uploading debug symbols to enable symbolication of stack traces in your Dart applications."
+sidebar_order: 3
+---
+
+Debug symbols are essential for understanding stack traces in your Dart application when errors occur. Without debug symbols, stack traces from minified or obfuscated code can be difficult or impossible to interpret.
+
+## What Are Debug Symbols?
+
+Debug symbols provide the necessary information to convert program addresses back to function names, source file names, and line numbers. When you build a Dart application, especially with obfuscation or optimization enabled, this information is typically removed from the main application bundle to reduce size.
+
+In Dart applications, debug symbols can include:
+
+- **For Dart code**: Symbol files generated when using `--split-debug-info` and `--obfuscate` flags
+- **For iOS/macOS**: dSYM files
+- **For Android**: Proguard/R8 mapping files and symbols files
+- **For Flutter Web**: Source maps
+- **For Android NDK**: ELF DWARF debug files
+
+## When to Upload Debug Symbols
+
+With default settings, complete stack traces are available in your Dart errors out of the box, unless you use [`split-debug-info`](https://flutter.dev/docs/perf/app-size#reducing-app-size) and [`obfuscate`](https://flutter.dev/docs/deployment/obfuscate) flags. In these cases, you must upload the debug information files generated by the build, so Sentry can show proper stack traces.
+
+## Upload Methods
+
+Sentry offers several methods to upload debug symbols for Dart applications:
+
+1. **[Sentry Dart Plugin (Recommended)](/platforms/dart/guides/flutter/debug-symbols/dart-plugin)** - The easiest way to automatically upload debug symbols for iOS, Android, and Web.
+
+2. **[Manual Upload Options](/platforms/dart/guides/flutter/debug-symbols/manual-upload):**
+   - [iOS and macOS](/platforms/apple/dsym/) - Upload dSYM files for symbolication of Apple platform crashes.
+   - [Android](/cli/dif/#uploading-files) - Upload mapping files manually using the Sentry CLI.
+   - [Android NDK](/cli/dif/#uploading-files) - Upload ELF DWARF debug files for native code crashes.
+   - [Web](/cli/releases/#upload-source-maps) - Upload source maps for Flutter web applications.
+
+Choose the method that best suits your workflow and platform requirements. For most users, the Sentry Dart Plugin provides the simplest solution across all platforms. 
diff --git a/docs/platforms/dart/guides/flutter/debug-symbols/manual-upload.mdx b/docs/platforms/dart/guides/flutter/debug-symbols/manual-upload.mdx
@@ -0,0 +1,9 @@
+---
+title: Manual Upload
+description: "Learn how to manually upload debug symbols for your Dart applications."
+sidebar_order: 2
+---
+
+If you choose not to use the Sentry Dart Plugin, you can manually upload debug symbols for your Dart applications. This page provides instructions for different platforms.
+
+<PlatformContent includePath="debug-symbols/manual-upload" /> 
diff --git a/docs/platforms/dart/guides/flutter/upload-debug.mdx b/docs/platforms/dart/guides/flutter/upload-debug.mdx