@sentry/expo-upload-sourcemaps
Command-line tool for uploading JavaScript bundles and source maps from Expo builds to Sentry, so that production error stack traces are symbolicated back to original source.
Usage
SENTRY_AUTH_TOKEN=<your-auth-token> \
npx @sentry/expo-upload-sourcemaps distdist is the output directory produced by npx expo export or eas update.
Environment variables
| Variable | Required | Description |
|---|---|---|
SENTRY_AUTH_TOKEN |
yes | Sentry auth token with project:write scope. |
SENTRY_ORG |
when no Expo plugin config is present | Sentry organization slug. Falls back to the @sentry/react-native/expo plugin config in app.json / app.config.ts, or the defaults.org entry in android/sentry.properties / ios/sentry.properties. |
SENTRY_PROJECT |
when no Expo plugin config is present | Sentry project slug. Same fallback order as above. |
SENTRY_URL |
optional | Sentry instance URL. Defaults to https://sentry.io/. |
SENTRY_CLI_EXECUTABLE |
optional | Path override for the sentry-cli binary. |
Environment variables are also read from .env.sentry-build-plugin at the project root.
Relation to @sentry/react-native
The same CLI is re-exposed inside @sentry/react-native under the bin name sentry-expo-upload-sourcemaps. Projects that already have @sentry/react-native installed can invoke either form:
npx @sentry/expo-upload-sourcemaps dist
# or
npx sentry-expo-upload-sourcemaps distThe new scoped form is preferred for new setups.
Documentation
See the Expo source maps guide for end-to-end setup.
License
Licensed under the MIT license. See LICENSE.md.