Skip to content

feat(react-native): Document environment/release/dist alignment for app start errors#18508

Open
antonis wants to merge 1 commit into
masterfrom
rn-app-start-env-alignment
Open

feat(react-native): Document environment/release/dist alignment for app start errors#18508
antonis wants to merge 1 commit into
masterfrom
rn-app-start-env-alignment

Conversation

@antonis

@antonis antonis commented Jun 23, 2026

Copy link
Copy Markdown
Contributor

DESCRIBE YOUR PR

Updates the Capture App Start Errors guide to explain how environment, release, and dist must stay aligned between the native SDK and JavaScript when using early native initialization.

Context: corresponds to SDK fix getsentry/sentry-react-native#6330 and the report in getsentry/sentry-react-native#6329.

IS YOUR CHANGE URGENT?

  • Urgent deadline (GA date, etc.):
  • Other deadline:
  • None: Not urgent, can wait up to 1 week+

⚠️ Should be merged after getsentry/sentry-react-native#6330 is released

PRE-MERGE CHECKLIST

Make sure you've checked the following before merging your changes:

  • Checked Vercel preview for correctness, including links
  • PR was reviewed and approved by any necessary SMEs (subject matter experts)
  • PR was reviewed and approved by a member of the Sentry docs team

EXTRA RESOURCES

@vercel

vercel Bot commented Jun 23, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
sentry-docs Ready Ready Preview, Comment Jun 23, 2026 10:07am
1 Skipped Deployment
Project Deployment Actions Updated (UTC)
develop-docs Ignored Ignored Preview Jun 23, 2026 10:07am

Request Review

…pp start errors

Add `environment` to the values that must match between sentry.options.json and
Sentry.init(), note that SENTRY_ENVIRONMENT/RELEASE/DIST now align both the native
copy and the JS-bundled options (SDK 8.16.0+), and connect a mismatch to release
health splitting (Failure Rate instead of Crash Free Session Rate).
@antonis antonis force-pushed the rn-app-start-env-alignment branch from 937a681 to 942a890 Compare June 23, 2026 09:56
}
```

Applying `SENTRY_RELEASE` and `SENTRY_DIST` from EAS to the JavaScript-bundled options requires Sentry React Native SDK version 8.16.0 or higher (see [Setting the Environment](#setting-the-environment) above). On earlier versions, also set matching values in `Sentry.init()`.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Adding a note to remember to validate the actual release version before merging

@coolguyzone coolguyzone left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good 👍

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants