feat(core): Generate sentry.options.json from Expo plugin config by antonis · Pull Request #5804 · getsentry/sentry-react-native

antonis · 2026-03-11T13:38:37Z

📢 Type of change

Bugfix
New feature
Enhancement
Refactoring

📜 Description

Adds an options property to the Expo config plugin that generates sentry.options.json during expo prebuild. This removes the need to manually create the file when using useNativeInit: true.

The plugin options are merged with any existing sentry.options.json (plugin options take precedence)
SENTRY_ENVIRONMENT env variable continues to work and takes precedence over options.environment
Updates the Expo sample to use the new options prop instead of a committed sentry.options.json

["@sentry/react-native/expo", {
  "useNativeInit": true,
  "options": {
    "dsn": "https://key@sentry.io/123",
    "environment": "staging",
    "tracesSampleRate": 1.0
  }
}]

⚠️ Note that this PR also changes the env variable in #5796 since it hasn't been released yet. If #5796 is released before this PR lands we may need to support env outside options too.

💡 Motivation and Context

Closes #5664

When using useNativeInit: true, users had to manually create a sentry.options.json file. This added unnecessary friction. Now the plugin can generate it from the Expo config.

💚 How did you test it?

Unit tests for writeSentryOptions (create, merge, precedence, invalid JSON, multiple options)
yarn build passes
yarn test passes
yarn lint:lerna passes
yarn circularDepCheck passes

📝 Checklist

I added tests to verify changes
No new PII added or SDK only sends newly added PII if sendDefaultPII is enabled
I updated the docs if needed feat(react-native): Document Expo plugin options for sentry.options.json generation sentry-docs#16885
I updated the wizard if needed.
All tests passing
No breaking changes

🔮 Next steps

Update docs to document the new options plugin property

Adds an `options` property to the Expo config plugin that generates `sentry.options.json` during prebuild, removing the need to manually create the file when using `useNativeInit: true`. Closes #5664 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

github-actions · 2026-03-11T13:39:01Z

Semver Impact of This PR

⚪ None (no version bump detected)

📋 Changelog Preview

This is how your changes will appear in the changelog.
Entries from this PR are highlighted with a left border (blockquote style).

feat(core): Generate sentry.options.json from Expo plugin config by antonis in #5804

fix(core): Exclude server-only AI/MCP modules from native bundles by antonis in #5802
chore(deps): update Cocoa SDK to v9.7.0 by github-actions in #5805
chore(deps): update CLI to v3.3.3 by github-actions in #5806
Automatically capture a warning event when Expo Updates performs an emergency launch by alwx in #5794
fix(core): Improve native init log message clarity by antonis in #5801
feat(core): Add environment option to Expo config plugin by antonis in #5796
chore(deps): update CLI to v3.3.2 by github-actions in #5799
chore(deps): update Maestro to v2.3.0 by github-actions in #5790
chore(deps): update JavaScript SDK to v10.43.0 by github-actions in #5791
chore(deps): update CLI to v3.3.1 by github-actions in #5793
fix(core): Defer initial navigation span creation until navigation container is registered by antonis in #5789
Ref(Sample): Add existing bundled playgroundscreen into sample app by lucas-zimerman in #5778
Auto tracing for expo-image and expo-asset by alwx in #5718
Expo Updates: add tags with Expo Updates context vars to make them searchable/filterable by alwx in #5788
chore(deps): bump actions/setup-node from 6.2.0 to 6.3.0 by dependabot in #5784
chore(deps): bump github/codeql-action from 4.32.4 to 4.32.6 by dependabot in #5781
chore(deps): bump getsentry/craft/.github/workflows/changelog-preview.yml from 2.23.1 to 2.23.2 by dependabot in #5782
chore(deps): bump getsentry/craft from 2.21.7 to 2.23.2 by dependabot in #5783
chore(deps): bump tar to ^7.5.10 by antonis in #5777

_{🤖 This preview updates automatically when you update the PR.}

github-actions · 2026-03-11T13:39:16Z

	Messages
📖	Do not forget to update Sentry-docs with your feature once the pull request gets approved.

Generated by 🚫 dangerJS against 2008b55

CHANGELOG.md

github-actions · 2026-03-11T14:13:22Z

iOS (legacy) Performance metrics 🚀

	Plain	With Sentry	Diff
Startup time	1213.23 ms	1217.16 ms	3.93 ms
Size	3.38 MiB	4.81 MiB	1.43 MiB

Baseline results on branch: main

Startup times

Revision	Plain	With Sentry	Diff
`ea3e26e`+dirty	1229.13 ms	1228.46 ms	-0.67 ms
`80e4616`+dirty	1221.32 ms	1225.64 ms	4.32 ms
`818a608`+dirty	1205.76 ms	1208.00 ms	2.24 ms
`77061ed`+dirty	1233.16 ms	1234.88 ms	1.71 ms
`bef3709`+dirty	1222.07 ms	1220.24 ms	-1.83 ms
`a206511`+dirty	1185.00 ms	1186.35 ms	1.35 ms
`74979ac`+dirty	1210.49 ms	1213.31 ms	2.82 ms
`a2bb688`+dirty	1223.53 ms	1232.90 ms	9.37 ms
`8a868fe`+dirty	1221.50 ms	1230.78 ms	9.28 ms
`d590428`+dirty	1211.77 ms	1220.51 ms	8.75 ms

App size

Revision	Plain	With Sentry	Diff
`ea3e26e`+dirty	3.41 MiB	4.58 MiB	1.17 MiB
`80e4616`+dirty	3.38 MiB	4.60 MiB	1.22 MiB
`818a608`+dirty	2.63 MiB	3.91 MiB	1.28 MiB
`77061ed`+dirty	2.63 MiB	3.98 MiB	1.34 MiB
`bef3709`+dirty	3.38 MiB	4.78 MiB	1.40 MiB
`a206511`+dirty	3.41 MiB	4.67 MiB	1.25 MiB
`74979ac`+dirty	3.38 MiB	4.60 MiB	1.22 MiB
`a2bb688`+dirty	2.63 MiB	3.99 MiB	1.36 MiB
`8a868fe`+dirty	3.38 MiB	4.60 MiB	1.22 MiB
`d590428`+dirty	3.38 MiB	4.78 MiB	1.39 MiB

antonis · 2026-03-11T14:21:40Z

@cursor review

antonis · 2026-03-11T14:21:49Z

@sentry review

cursor

✅ Bugbot reviewed your changes and found no new issues!

Comment @cursor review or bugbot run to trigger another review on this PR

github-actions · 2026-03-11T14:32:44Z

iOS (new) Performance metrics 🚀

	Plain	With Sentry	Diff
Startup time	1219.35 ms	1216.27 ms	-3.08 ms
Size	3.38 MiB	4.81 MiB	1.43 MiB

Baseline results on branch: main

Startup times

Revision	Plain	With Sentry	Diff
`ea3e26e`+dirty	1216.61 ms	1214.15 ms	-2.47 ms
`80e4616`+dirty	1206.90 ms	1205.94 ms	-0.96 ms
`818a608`+dirty	1218.84 ms	1223.18 ms	4.34 ms
`77061ed`+dirty	1210.77 ms	1218.45 ms	7.68 ms
`bef3709`+dirty	1217.79 ms	1225.33 ms	7.54 ms
`a206511`+dirty	1225.02 ms	1223.74 ms	-1.28 ms
`74979ac`+dirty	1212.33 ms	1212.54 ms	0.21 ms
`a2bb688`+dirty	1244.82 ms	1238.60 ms	-6.22 ms
`8a868fe`+dirty	1206.85 ms	1215.04 ms	8.19 ms
`d590428`+dirty	1221.23 ms	1225.27 ms	4.03 ms

App size

Revision	Plain	With Sentry	Diff
`ea3e26e`+dirty	3.41 MiB	4.58 MiB	1.17 MiB
`80e4616`+dirty	3.38 MiB	4.60 MiB	1.22 MiB
`818a608`+dirty	3.19 MiB	4.48 MiB	1.29 MiB
`77061ed`+dirty	3.19 MiB	4.54 MiB	1.36 MiB
`bef3709`+dirty	3.38 MiB	4.78 MiB	1.40 MiB
`a206511`+dirty	3.41 MiB	4.67 MiB	1.25 MiB
`74979ac`+dirty	3.38 MiB	4.60 MiB	1.22 MiB
`a2bb688`+dirty	3.19 MiB	4.56 MiB	1.37 MiB
`8a868fe`+dirty	3.38 MiB	4.60 MiB	1.22 MiB
`d590428`+dirty	3.38 MiB	4.78 MiB	1.39 MiB

github-actions · 2026-03-11T14:38:33Z

Android (legacy) Performance metrics 🚀

	Plain	With Sentry	Diff
Startup time	527.51 ms	560.02 ms	32.51 ms
Size	43.75 MiB	48.50 MiB	4.75 MiB

Baseline results on branch: main

Startup times

Revision	Plain	With Sentry	Diff
`86584b7`+dirty	463.83 ms	500.31 ms	36.48 ms
`9a81842`+dirty	412.23 ms	416.56 ms	4.33 ms
`c637fc7`+dirty	433.70 ms	467.76 ms	34.06 ms
`d73150f`+dirty	411.21 ms	465.86 ms	54.65 ms
`fa7bb7e`+dirty	350.37 ms	377.02 ms	26.65 ms
`3bd3f0d`+dirty	447.21 ms	472.31 ms	25.10 ms
`88890fe`+dirty	350.94 ms	365.74 ms	14.80 ms
`95aaf8a`	437.89 ms	419.45 ms	-18.44 ms
`c0842e7`+dirty	527.76 ms	566.69 ms	38.93 ms
`1e7a472`+dirty	348.80 ms	362.55 ms	13.75 ms

App size

Revision	Plain	With Sentry	Diff
`86584b7`+dirty	43.75 MiB	48.08 MiB	4.33 MiB
`9a81842`+dirty	43.75 MiB	48.08 MiB	4.33 MiB
`c637fc7`+dirty	43.75 MiB	48.40 MiB	4.64 MiB
`d73150f`+dirty	43.75 MiB	48.55 MiB	4.80 MiB
`fa7bb7e`+dirty	17.75 MiB	19.75 MiB	2.00 MiB
`3bd3f0d`+dirty	17.75 MiB	19.70 MiB	1.95 MiB
`88890fe`+dirty	17.75 MiB	19.71 MiB	1.96 MiB
`95aaf8a`	17.75 MiB	19.68 MiB	1.93 MiB
`c0842e7`+dirty	43.75 MiB	48.41 MiB	4.66 MiB
`1e7a472`+dirty	17.75 MiB	19.70 MiB	1.96 MiB

github-actions · 2026-03-11T14:52:39Z

Android (new) Performance metrics 🚀

	Plain	With Sentry	Diff
Startup time	401.19 ms	436.32 ms	35.13 ms
Size	43.94 MiB	49.36 MiB	5.42 MiB

Baseline results on branch: main

Startup times

Revision	Plain	With Sentry	Diff
`7480abe`+dirty	363.80 ms	431.34 ms	67.54 ms
`2b89ce9`+dirty	372.22 ms	417.06 ms	44.84 ms
`170d5ea`+dirty	348.79 ms	406.94 ms	58.15 ms
`b1579bc`+dirty	391.87 ms	456.26 ms	64.39 ms
`73f2455`+dirty	369.33 ms	398.90 ms	29.57 ms
`0b64753`+dirty	358.55 ms	429.16 ms	70.61 ms
`6a70a7e`+dirty	382.45 ms	424.54 ms	42.09 ms
`2adbd1e`+dirty	366.13 ms	419.49 ms	53.36 ms
`f8d19f8`+dirty	374.17 ms	383.40 ms	9.23 ms
`7be1f99`+dirty	369.02 ms	399.60 ms	30.58 ms

App size

Revision	Plain	With Sentry	Diff
`7480abe`+dirty	7.15 MiB	8.41 MiB	1.26 MiB
`2b89ce9`+dirty	7.15 MiB	8.41 MiB	1.26 MiB
`170d5ea`+dirty	7.15 MiB	8.42 MiB	1.27 MiB
`b1579bc`+dirty	43.94 MiB	49.27 MiB	5.33 MiB
`73f2455`+dirty	43.94 MiB	48.82 MiB	4.88 MiB
`0b64753`+dirty	7.15 MiB	8.42 MiB	1.27 MiB
`6a70a7e`+dirty	7.15 MiB	8.42 MiB	1.26 MiB
`2adbd1e`+dirty	7.15 MiB	8.43 MiB	1.28 MiB
`f8d19f8`+dirty	43.94 MiB	48.91 MiB	4.97 MiB
`7be1f99`+dirty	7.15 MiB	8.42 MiB	1.27 MiB

lucas-zimerman · 2026-03-12T12:30:29Z

samples/expo/app.json

-    "assetBundlePatterns": [
-      "**/*"
-    ],
+    "assetBundlePatterns": ["**/*"],


I wonder why each CI decides to change this format every run

This is an irrelevant formatting thing after running yarn fix locally. I can probably revert it but I guess it will come back

No worries about that, maybe we can set some flag so yarn fix knows how to format these files.
But super low priority for doing that

packages/core/plugin/src/utils.ts

Co-authored-by: LucasZF <lucas-zimerman1@hotmail.com>

lucas-zimerman · 2026-03-12T12:34:51Z

samples/expo/app.json

          "useNativeInit": true,
+          "options": {
+            "dsn": "https://1df17bd4e543fdb31351dee1768bb679@o447951.ingest.sentry.io/5428561",
+            "debug": true,


q: What if the user sets enableNative: false here?

What do you think of removing useNativeInit on v9 and move it inside options?

lucas-zimerman

LGTM!

antonis commented Mar 11, 2026

View reviewed changes

CHANGELOG.md Outdated Show resolved Hide resolved

Update changelog

eb37aa4

antonis mentioned this pull request Mar 11, 2026

feat(react-native): Document Expo plugin options for sentry.options.json generation getsentry/sentry-docs#16885

Open

6 tasks

antonis added the ready-to-merge Triggers the full CI test suite label Mar 11, 2026

cursor bot reviewed Mar 11, 2026

View reviewed changes

antonis marked this pull request as ready for review March 11, 2026 14:51

antonis requested review from alwx and lucas-zimerman as code owners March 11, 2026 14:51

lucas-zimerman reviewed Mar 12, 2026

View reviewed changes

packages/core/plugin/src/utils.ts Outdated Show resolved Hide resolved

Change message for clarity

2008b55

Co-authored-by: LucasZF <lucas-zimerman1@hotmail.com>

lucas-zimerman reviewed Mar 12, 2026

View reviewed changes

lucas-zimerman approved these changes Mar 12, 2026

View reviewed changes

Uh oh!

Conversation

antonis commented Mar 11, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

📢 Type of change

📜 Description

💡 Motivation and Context

💚 How did you test it?

📝 Checklist

🔮 Next steps

Uh oh!

github-actions bot commented Mar 11, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Semver Impact of This PR

Uh oh!

github-actions bot commented Mar 11, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

github-actions bot commented Mar 11, 2026

iOS (legacy) Performance metrics 🚀

Baseline results on branch: main

Startup times

App size

Uh oh!

antonis commented Mar 11, 2026

Uh oh!

antonis commented Mar 11, 2026

Uh oh!

cursor bot left a comment

Choose a reason for hiding this comment

Uh oh!

github-actions bot commented Mar 11, 2026

iOS (new) Performance metrics 🚀

Baseline results on branch: main

Startup times

App size

Uh oh!

github-actions bot commented Mar 11, 2026

Android (legacy) Performance metrics 🚀

Baseline results on branch: main

Startup times

App size

Uh oh!

github-actions bot commented Mar 11, 2026

Android (new) Performance metrics 🚀

Baseline results on branch: main

Startup times

App size

Uh oh!

lucas-zimerman Mar 12, 2026

Choose a reason for hiding this comment

Uh oh!

antonis Mar 12, 2026

Choose a reason for hiding this comment

Uh oh!

lucas-zimerman Mar 12, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

lucas-zimerman Mar 12, 2026

Choose a reason for hiding this comment

Uh oh!

lucas-zimerman Mar 12, 2026

Choose a reason for hiding this comment

Uh oh!

lucas-zimerman left a comment

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

antonis commented Mar 11, 2026 •

edited

Loading

github-actions bot commented Mar 11, 2026 •

edited

Loading

github-actions bot commented Mar 11, 2026 •

edited

Loading