From f8ab55820c7e17f9a9a6293ecbf688ea44d2c80b Mon Sep 17 00:00:00 2001 From: Antonis Lilis Date: Tue, 21 Apr 2026 10:47:09 +0200 Subject: [PATCH] docs(react-native): Recommend @sentry/expo-upload-sourcemaps for Expo source maps Prefer the new scoped CLI package as the primary invocation form, with a version-gated note for users on @sentry/react-native older than 8.9.0 who should continue to use the bin bundled with the SDK. Co-Authored-By: Claude Opus 4.7 (1M context) --- .../react-native/sourcemaps/uploading/expo.mdx | 16 ++++++++++++++-- 1 file changed, 14 insertions(+), 2 deletions(-) diff --git a/docs/platforms/react-native/sourcemaps/uploading/expo.mdx b/docs/platforms/react-native/sourcemaps/uploading/expo.mdx index 4c16d162e5f3c..14fd15a489c92 100644 --- a/docs/platforms/react-native/sourcemaps/uploading/expo.mdx +++ b/docs/platforms/react-native/sourcemaps/uploading/expo.mdx @@ -21,7 +21,7 @@ When the Sentry Expo Plugin `@sentry/react-native/expo` and the Sentry Metro Plu ## Manual Upload for EAS Updates -To upload source maps for EAS Updates and `npx expo export`, set up the Sentry Expo Plugin, the Sentry Metro plugin and execute the `sentry-expo-upload-sourcemaps` command. +To upload source maps for EAS Updates and `npx expo export`, set up the Sentry Expo Plugin, the Sentry Metro plugin and execute the `@sentry/expo-upload-sourcemaps` command. ### Create Update @@ -38,7 +38,7 @@ To upload source maps for all platforms use the following command: ```bash SENTRY_AUTH_TOKEN=___ORG_AUTH_TOKEN___ \ -npx --package=@sentry/react-native sentry-expo-upload-sourcemaps dist +npx @sentry/expo-upload-sourcemaps dist ``` To upload source maps without expo plugin (bare workflow): @@ -48,9 +48,21 @@ SENTRY_AUTH_TOKEN=___ORG_AUTH_TOKEN___ \ SENTRY_PROJECT=___PROJECT_SLUG___ \ SENTRY_ORG=___ORG_SLUG___ \ SENTRY_URL=https://sentry.io/ \ +npx @sentry/expo-upload-sourcemaps dist +``` + + + +The `@sentry/expo-upload-sourcemaps` package is available starting with `@sentry/react-native` 8.9.0. If you are on an older version, invoke the bin bundled with the SDK instead: + +```bash npx --package=@sentry/react-native sentry-expo-upload-sourcemaps dist ``` +Both forms produce identical results; the scoped package is preferred for new setups. + + + #### Notes