getsentry · mtopo27 · Oct 16, 2025 · Oct 17, 2025 · Oct 17, 2025 · Oct 20, 2025
diff --git a/develop-docs/frontend/using-rtl.mdx b/develop-docs/frontend/using-rtl.mdx
@@ -20,7 +20,7 @@ As a part of this goal, we avoid testing implementation details so refactors (ch
 We are generally in favor of Use Case Coverage over Code Coverage.
 
 ## Use our built-in contexts
-By default, `render()` has some default contexts setup for you. The organization context is set to `OrganizationFixture()` and the router context has some default params like orgId and projectId. These can be overriden by passing a property to the 2nd argument of the `render()` function.
+By default, `render()` has some default contexts setup for you. The organization context is set to `OrganizationFixture()` and the router context has some default params like orgId and projectId. These can be overridden by passing a property to the 2nd argument of the `render()` function.
 
 Example of overriding the default organization features and access:
 ```tsx

diff --git a/docs/organization/early-adopter-features/index.mdx b/docs/organization/early-adopter-features/index.mdx
@@ -23,3 +23,4 @@ Limitations:
 - [Span Summary](/product/insights/overview/transaction-summary/#span-summary)
 - [Dynamic Alerts](/product/alerts/create-alerts/metric-alert-config/#dynamic-alerts)
 - [New Trace Explorer With Span Metrics](/product/explore/new-trace-explorer/)
+- [Size Analysis](/product/size-analysis/)
diff --git a/docs/platforms/android/size-analysis/index.mdx b/docs/platforms/android/size-analysis/index.mdx
@@ -0,0 +1,38 @@
+---
+title: Size Analysis
+sidebar_title: Size Analysis
+sidebar_order: 5200
+description: Upload Android builds to Sentry for Size Analysis.
+---
+
+<Include name="size-analysis/ea" />
+
+[Size Analysis](/product/size-analysis) helps monitor your mobile app's size in pre-production to prevent unexpected size increases (regressions) from reaching users. Aside from being courteous to your users, a smaller app size helps boost installation and retention rates, especially for customers with limited storage or slower connections.
+
+## Getting Started
+
+**Accepted Formats**: AAB (preferred) | APK
+
+**Upload Mechanisms**: [Gradle](#uploading-with-gradle) | [Sentry CLI](#uploading-with-the-sentry-cli)
+
+### Uploading With Gradle
+
+<Include name="size-analysis/upload-gradle" />
+
+### Uploading With the Sentry CLI
+
+<Include name="size-analysis/upload-cli-android" />
+
+## Upload Metadata
+
+<Include name="size-analysis/upload-metadata" />
+
+### Build Configuration
+
+<Include name="size-analysis/build-configuration-android" />
+
+## What's Next?
+
+We strongly recommend integrating Size Analysis into your CI pipeline. Follow our guide on [getting set up in CI](/product/size-analysis/integrating-into-ci/).
+
+<PageGrid />
diff --git a/docs/platforms/android/size-analysis/insights.mdx b/docs/platforms/android/size-analysis/insights.mdx
@@ -0,0 +1,108 @@
+---
+title: Insights
+sidebar_order: 5250
+description: Preview how Size Analysis reports highlight Android build trends.
+---
+
+Size Analysis Insights point out opportunities to reduce your Android app's size. They spot patterns like duplicate files, oversized media, or unneeded assets, and list exactly what to fix along with the estimated size savings.
+
+## Android Insights
+
+Below are a list of available insights for Android builds, followed by more details about each insight:
+
+| Insight                                                   | What it flags                                                         |
+| --------------------------------------------------------- | --------------------------------------------------------------------- |
+| [Duplicate Files](#duplicate-files)                       | Flags identical payloads so you can drop the duplicates               |
+| [Large Images](#large-images)                             | Surfaces oversized image assets worth recompressing or resizing.      |
+| [Large Videos](#large-videos)                             | Highlights video files that are bigger than typical delivery budgets. |
+| [WebP Optimization](#webp-optimization)                   | Tests PNG/JPEG bitmaps to see if lossless WebP would shrink them.     |
+| [Large Audio](#large-audio)                               | Surfaces hefty audio tracks that could be recompressed or trimmed.    |
+| [Hermes Debug Info (RN Only)](#hermes-debug-info-rn-only) | Points to bundled Hermes bytecode still carrying debugger metadata.   |
+
+### Duplicate Files
+
+**What it is**: Finds matching files or directories inside `assets/`, `res/`, or embedded libraries. Duplicate files are determined by examining the file hash, ensuring these are truly duplicates and not just similar files or the same file name.
+
+**How to fix**: Keep one copy and remove or dedupe the rest. For resource folders, consolidate the asset into a shared module or asset pack so the APK only bundles it once.
+
+### Large Images
+
+**What it is**: Flags image files larger than 10 MB.
+
+**How to fix**: Compress images with lossless WebP or resize them before bundling.
+
+
+**Options:**
+
+- Use Android Studio: right-click an image → **Convert to WebP** → select **Lossless**.
+- Use the command line:
+
+  ```bash
+  # Install cwebp
+  brew install webp
+
+  # Convert PNG to lossless WebP
+  cwebp -lossless input.png -o output.webp
+
+  # Convert JPEG to lossless WebP
+  cwebp -lossless input.jpg -o output.webp
+  ```
+
+Large hero images or splash screens may also load more efficiently if served over the network instead of being bundled with the app.
+
+### Large Videos
+
+**What it is**: Highlights bundled video assets above 10 MB.
+
+**How to fix**: Re-encode them to H.264 or HEVC with a lower bitrate, shorten the clip, or host the video remotely and stream it on demand. To shrink a clip in place, try FFmpeg:
+
+```bash
+ffmpeg -i input.mp4 -c:v libx264 -crf 23 -preset slow -c:a copy output.mp4
+```
+
+Lower the `-crf` value for higher quality (and larger files), or raise it for smaller files.
+
+### WebP Optimization
+
+**What it is**: Tests every PNG, BMP, JPG, or JPEG (excluding `.9.png`) against lossless WebP conversion. If the WebP variant saves at least 500 bytes, the insight lists the asset.
+
+**How to fix**: Convert the listed bitmap to lossless WebP and update its references. Pick one of the paths below.
+
+#### Option 1: Android Studio
+
+1. In Android Studio, right-click the image.
+2. Choose **Convert to WebP…**.
+3. Select **Lossless** (API 18+ supports it) and review the preview.
+
+#### Option 2: Command line
+
+```bash
+# Install cwebp
+brew install webp
+
+# Convert PNG to lossless WebP
+cwebp -lossless input.png -o output.webp
+
+# Convert JPEG to lossless WebP
+cwebp -lossless input.jpg -o output.webp
+```
+
+> Lossless WebP with alpha requires `minSdkVersion` ≥ 18. For older devices, keep PNG fallbacks for assets that rely on transparency.
+
+### Large Audio
+
+**What it is**: Surfaces audio files larger than 5 MB across `res/raw`, `assets`, or libraries.
+
+**How to fix**: Re-encode them at a lower bitrate or modern format using FFmpeg or your DAW, trim unused segments, or stream long-form media instead of bundling it. A quick FFmpeg recompress:
+
+```bash
+ffmpeg -i input.wav -c:a aac -b:a 128k output.m4a
+```
+
+You can tweak the bitrate (`b:a`) to balance quality vs. size. Higher bitrates (192k-256k) will be higher quality, but larger size. Lower bitrates (96k-128k) will be lower quality, but smaller size. If your audio file is voice-only, you can use a lower bitrate with little degradation in quality. Music files may benefit from a higher bitrate.
+
+### Hermes Debug Info (RN Only)
+
+**What it is**: Detects Hermes bytecode bundles that still contain debug info sections.
+
+**How to fix**: Build the React Native bundle in release mode (`react-native bundle --dev false` or the Gradle release task) so Hermes strips debug sections before packaging.
diff --git a/docs/platforms/apple/common/user-feedback/configuration/index.mdx b/docs/platforms/apple/common/user-feedback/configuration/index.mdx
@@ -151,7 +151,7 @@ SentrySDK.start { options in
 
 ### Accessibility
 
-The Feedback widget is designed to be accessible, with a set of default accessibility labels that can be overriden. The following attributes are set to ensure the widget is accessible:
+The Feedback widget is designed to be accessible, with a set of default accessibility labels that can be overridden. The following attributes are set to ensure the widget is accessible:
 
 #### `SentryUserFeedbackWidgetConfiguration`
 

diff --git a/docs/platforms/apple/guides/ios/size-analysis/images/exported-symbols.png b/docs/platforms/apple/guides/ios/size-analysis/images/exported-symbols.png
diff --git a/docs/platforms/apple/guides/ios/size-analysis/images/strip-symbols.png b/docs/platforms/apple/guides/ios/size-analysis/images/strip-symbols.png
diff --git a/docs/platforms/apple/guides/ios/size-analysis/index.mdx b/docs/platforms/apple/guides/ios/size-analysis/index.mdx
@@ -0,0 +1,51 @@
+---
+title: Size Analysis
+sidebar_order: 5200
+description: Upload iOS builds to Sentry for size analysis.
+---
+
+<Include name="size-analysis/ea" />
+
+[Size Analysis](/product/size-analysis) helps monitor your mobile app's size in pre-production to prevent unexpected size increases (regressions) from reaching users. Aside from being courteous to your users, a smaller app size helps boost installation and retention rates, especially for customers with limited storage or slower connections.
+
+## Getting Started
+
+**Accepted Formats**: XCArchive (preferred) | IPA
+
+**Upload Mechanisms**: [Fastlane Plugin](#uploading-with-fastlane) (version 1.34.0 or higher) *or* [Sentry CLI](#uploading-with-the-sentry-cli)
+
+### Uploading With Fastlane
+
+<Include name="size-analysis/upload-fastlane" />
+
+### Uploading with the Sentry CLI
+
+<Include name="size-analysis/upload-cli-ios" />
+
+## Upload Metadata
+
+<Include name="size-analysis/upload-metadata" />
+
+### Build Configuration
+
+<Include name="size-analysis/build-configuration-ios" />
+
+## Understanding App Size
+
+### What We're Measuring
+
+<Include name="size-analysis/what-were-measuring" />
+
+### App Thinning
+
+<Include name="size-analysis/app-thinning" />
+
+### App Store Connect File Sizes
+
+<Include name="size-analysis/app-store-connect-file-sizes" />
+
+## What's Next?
+
+We strongly recommend integrating Size Analysis into your CI pipeline. Follow our guide on [getting set up in CI](/product/size-analysis/integrating-into-ci/).
+
+<PageGrid />