# @sentry/expo-upload-sourcemaps

> CLI to upload bundles and source maps from Expo builds to Sentry.

Latest version **8.26.0** (published 2026-09-10) · MIT license · 0 weekly downloads

## Install

```sh
npm install @sentry/expo-upload-sourcemaps
pnpm add @sentry/expo-upload-sourcemaps
yarn add @sentry/expo-upload-sourcemaps
bun add @sentry/expo-upload-sourcemaps
```

Provides the command `expo-upload-sourcemaps`.

## Health

**Score 55/100 (C)** — status: active.

Positive: no vulnerabilities; recently updated; high maintenance score.

Warnings: low downloads; no types; no esm support.

## Facts

| | |
|---|---|
| Version | 8.26.0 |
| Published | 2026-09-10 |
| First published | 2026-04-23 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Node | >=18 |
| Dependencies | 1 |
| Unpacked size | 15.4 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 1823 |
| Author | Sentry |
| Maintainers | sentry-bot |
| Keywords | sentry, expo, react-native, sourcemaps, cli |

## Links

- npm: https://www.npmjs.com/package/@sentry/expo-upload-sourcemaps
- Repository: https://github.com/getsentry/sentry-react-native
- Homepage: https://github.com/getsentry/sentry-react-native/tree/main/packages/expo-upload-sourcemaps
- Issues: https://github.com/getsentry/sentry-react-native/issues
- npm.io page: https://npm.io/package/@sentry/expo-upload-sourcemaps

## Dependencies (1)

- [@sentry/cli](https://npm.io/package/@sentry/cli.md) 3.7.0

## Alternatives

- [@salesforce/cli](https://npm.io/package/@salesforce/cli.md) — 389.7K weekly downloads
- [@mintlify/cli](https://npm.io/package/@mintlify/cli.md) — 208.9K weekly downloads
- [@grafana/e2e-selectors](https://npm.io/package/@grafana/e2e-selectors.md) — 128.7K weekly downloads
- [mintlify](https://npm.io/package/mintlify.md) — 112.0K weekly downloads
- [@intlayer/cli](https://npm.io/package/@intlayer/cli.md) — 22.8K weekly downloads

## Recent versions

- 8.26.0 (latest) — 2026-09-10
- 8.14.3 (v8.14) — 2026-09-01
- 8.18.0-alpha.3 (next) — 2026-07-06
- 8.25.0 — 2026-09-03
- 8.24.0 — 2026-08-27
- 8.23.0 — 2026-08-13
- 8.22.0 — 2026-08-06
- 8.21.0 — 2026-07-30
- 8.20.0 — 2026-07-23
- 8.19.0 — 2026-07-16
- 8.14.2 — 2026-07-16
- 8.18.0 — 2026-07-09
- 8.18.0-alpha.2 — 2026-07-06
- 8.18.0-alpha — 2026-07-06
- 8.17.2 — 2026-07-06
- … 14 more at https://npm.io/package/@sentry/expo-upload-sourcemaps/versions

## README

<p align="center">
  <a href="https://sentry.io/?utm_source=github&utm_medium=logo" target="_blank">
    <picture>
      <source srcset="https://sentry-brand.storage.googleapis.com/sentry-logo-white.png" media="(prefers-color-scheme: dark)" />
      <source srcset="https://sentry-brand.storage.googleapis.com/sentry-logo-black.png" media="(prefers-color-scheme: light), (prefers-color-scheme: no-preference)" />
      <img src="https://sentry-brand.storage.googleapis.com/sentry-logo-black.png" alt="Sentry" width="280" />
    </picture>
  </a>
</p>

# @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

```bash
SENTRY_AUTH_TOKEN=<your-auth-token> \
npx @sentry/expo-upload-sourcemaps dist
```

`dist` 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:

```bash
npx @sentry/expo-upload-sourcemaps dist
# or
npx sentry-expo-upload-sourcemaps dist
```

The new scoped form is preferred for new setups.

## Documentation

See the [Expo source maps guide](https://docs.sentry.io/platforms/react-native/sourcemaps/uploading/expo/) for end-to-end setup.

## License

Licensed under the MIT license. See [`LICENSE.md`](./LICENSE.md).

---
_Source: https://npm.io/package/@sentry/expo-upload-sourcemaps · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
