Symbolication

Production builds ship obfuscated (Android), minified (JavaScript) or stripped (iOS) code. Upload the matching symbol file and CrashCart turns a.b.c.d into CartFragment.onResume, with file names and line numbers.

Symbol file	Platform	Needs
ProGuard / R8 mapping	Android	Nothing extra
Source map	JavaScript, React Native	Nothing extra
dSYM	iOS, macOS	The optional symbolication sidecar

Uploading

In the viewer: Settings → Symbols.

With curl:

curl -H "Authorization: Bearer $API_KEY" \
     -F kind=proguard -F release=2.4.1 -F file=@mapping.txt \
     https://crashcart.example.com/api/projects/shop-android/symbols

kind is proguard, sourcemap or dsym. release must be the release string your SDK sends.

With sentry-cli, which most CI setups already use:

export SENTRY_URL=https://crashcart.example.com
export SENTRY_AUTH_TOKEN=$API_KEY
export SENTRY_ORG=any            # ignored
export SENTRY_PROJECT=shop-ios   # the CrashCart slug

sentry-cli debug-files upload path/to/App.dSYM
sentry-cli upload-proguard mapping.txt

Files uploaded through sentry-cli don't need a release — they are matched to events by debug id, which is more robust. Make sure PUBLIC_URL is set so sentry-cli can reach the upload URL from your CI.

Android

The Sentry Android Gradle plugin uploads the mapping on every build. Point it at CrashCart in sentry.properties:

defaults.url=https://crashcart.example.com
defaults.org=any
defaults.project=shop-android
auth.token=<API key>

JavaScript / React Native

Upload each bundle's .map under the release the SDK reports:

curl -H "Authorization: Bearer $API_KEY" \
     -F kind=sourcemap -F release=shop-web@2.4.1 -F file=@dist/app.js.map \
     https://crashcart.example.com/api/projects/shop-web/symbols

Keep release identical in Sentry.init() and the upload.

iOS / macOS

dSYM symbolication needs the sidecar container. With Docker Compose, uncomment the symbolicate service in docker-compose.yml and set SYMBOLICATE_URL=http://symbolicate:8080 in .env; other installs run the container/symbolicate image next to CrashCart and set SYMBOLICATE_URL to its address. Then upload dSYMs with sentry-cli debug-files upload.

Without the sidecar, iOS crashes are still collected and grouped — the frames just stay as addresses.

Already-collected events

Uploading a symbol file also symbolicates events from the last 48 hours (the COMPRESS_AFTER setting). Older events keep their original frames.