From 2dda88171f9da796581c8c2611ea14c70797efce Mon Sep 17 00:00:00 2001
From: Itay Brenner <itay.brenner@sentry.io>
Date: Tue, 26 May 2026 16:52:04 -0400
Subject: [PATCH] docs(apple, android): Enable standalone app start tracing in
 getting started guides

Add experimental.enableStandaloneAppStartTracing to all Apple platform
getting started code snippets (Swift, Objective-C, SwiftUI) and
io.sentry.standalone-app-start-tracing.enable to the Android manifest,
within the tracing product option section for more accurate app start
measurements.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 docs/platforms/android/index.mdx            |  2 ++
 includes/apple-platform-getting-started.mdx | 18 ++++++++++++++++++
 2 files changed, 20 insertions(+)

diff --git a/docs/platforms/android/index.mdx b/docs/platforms/android/index.mdx
index e4264395c361f..48cd7cf7a28ab 100644
--- a/docs/platforms/android/index.mdx
+++ b/docs/platforms/android/index.mdx
@@ -122,6 +122,8 @@ Configuration is done via the application `AndroidManifest.xml`. Here's an examp
   <!-- ___PRODUCT_OPTION_START___ performance -->
   <!-- Enable the performance API by setting a sample-rate, adjust in production env -->
   <meta-data android:name="io.sentry.traces.sample-rate" android:value="1.0" />
+  <!-- Send app start data as a standalone transaction for more accurate measurements -->
+  <meta-data android:name="io.sentry.standalone-app-start-tracing.enable" android:value="true" />
   <!-- ___PRODUCT_OPTION_END___ performance -->
   <!-- ___PRODUCT_OPTION_START___ profiling -->
   <!-- Enable profiling, adjust in production env. This is evaluated only once per session -->
diff --git a/includes/apple-platform-getting-started.mdx b/includes/apple-platform-getting-started.mdx
index 4dd43e88c2a56..18ddf1f4f84d8 100644
--- a/includes/apple-platform-getting-started.mdx
+++ b/includes/apple-platform-getting-started.mdx
@@ -111,6 +111,9 @@ func application(_ application: UIApplication,
         // Set tracesSampleRate to 1 to capture 100% of transactions for performance monitoring.
         // We recommend adjusting this value in production.
         options.tracesSampleRate = 1
+
+        // Send app start data as a standalone transaction for more accurate measurements.
+        options.experimental.enableStandaloneAppStartTracing = true
         // ___PRODUCT_OPTION_END___ performance
         // ___PRODUCT_OPTION_START___ profiling
 
@@ -153,6 +156,9 @@ func application(_ application: UIApplication,
         // Set tracesSampleRate to 1.0 to capture 100% of transactions for performance monitoring.
         // We recommend adjusting this value in production.
         options.tracesSampleRate = @1.f;
+
+        // Send app start data as a standalone transaction for more accurate measurements.
+        options.experimental.enableStandaloneAppStartTracing = YES;
         // ___PRODUCT_OPTION_END___ performance
         // ___PRODUCT_OPTION_START___ profiling
 
@@ -196,6 +202,9 @@ struct SwiftUIApp: App {
             // Set tracesSampleRate to 1 to capture 100% of transactions for performance monitoring.
             // We recommend adjusting this value in production.
             options.tracesSampleRate = 1
+
+            // Send app start data as a standalone transaction for more accurate measurements.
+            options.experimental.enableStandaloneAppStartTracing = true
             // ___PRODUCT_OPTION_END___ performance
             // ___PRODUCT_OPTION_START___ profiling
 
@@ -240,6 +249,9 @@ func application(_ application: UIApplication,
         // Set tracesSampleRate to 1 to capture 100% of transactions for performance monitoring.
         // We recommend adjusting this value in production.
         options.tracesSampleRate = 1
+
+        // Send app start data as a standalone transaction for more accurate measurements.
+        options.experimental.enableStandaloneAppStartTracing = true
         // ___PRODUCT_OPTION_END___ performance
         // ___PRODUCT_OPTION_START___ profiling
 
@@ -276,6 +288,9 @@ func application(_ application: UIApplication,
         // Set tracesSampleRate to 1.0 to capture 100% of transactions for performance monitoring.
         // We recommend adjusting this value in production.
         options.tracesSampleRate = @1.f;
+
+        // Send app start data as a standalone transaction for more accurate measurements.
+        options.experimental.enableStandaloneAppStartTracing = YES;
         // ___PRODUCT_OPTION_END___ performance
 
         // ___PRODUCT_OPTION_START___ profiling
@@ -313,6 +328,9 @@ struct SwiftUIApp: App {
             // Set tracesSampleRate to 1 to capture 100% of transactions for performance monitoring.
             // We recommend adjusting this value in production.
             options.tracesSampleRate = 1
+
+            // Send app start data as a standalone transaction for more accurate measurements.
+            options.experimental.enableStandaloneAppStartTracing = true
             // ___PRODUCT_OPTION_END___ performance
             // ___PRODUCT_OPTION_START___ profiling