Skip to content

feat(react-native): Add Expo as a guide under React Native#18476

Merged
antonis merged 10 commits into
masterfrom
rn-expo-guide-spike
Jun 30, 2026
Merged

feat(react-native): Add Expo as a guide under React Native#18476
antonis merged 10 commits into
masterfrom
rn-expo-guide-spike

Conversation

@antonis

@antonis antonis commented Jun 18, 2026

Copy link
Copy Markdown
Contributor

DESCRIBE YOUR PR

Makes Expo a first-class guide under the React Native platform, mirroring how Dart>Flutter and the JavaScript platform are structured.

Fixes getsentry/sentry-react-native#6270.

IS YOUR CHANGE URGENT?

  • None: Not urgent, can wait up to 1 week+

PRE-MERGE CHECKLIST

  • 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 18, 2026

Copy link
Copy Markdown

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

Project Deployment Actions Updated (UTC)
develop-docs Ready Ready Preview, Comment Jun 30, 2026 8:14am
sentry-docs Ready Ready Preview, Comment Jun 30, 2026 8:14am

Request Review

Make Expo a first-class guide under the React Native platform, mirroring
the Dart>Flutter and JavaScript platform grouping. The docs home page and
platform selector now show a single "React Native" dropdown containing
"React Native" (bare/CLI) and "Expo" as siblings, with the Expo brand icon.

- Move docs/platforms/react-native/* into common/ so the platform and its
  guides share content (public URLs are unchanged)
- Add config.yml with platformTitle to drive the dropdown grouping
- Add guides/expo/index.mdx Expo getting-started landing page
- Add the Expo platform icon: a local copy of the (as-yet unreleased)
  getsentry/platformicons svg/expo.svg, wired through PLATFORM_TO_ICON so
  the react-native.expo guide key resolves to it instead of the React icon

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Comment thread docs/platforms/react-native/guides/expo/index.mdx Outdated
Comment thread docs/platforms/react-native/guides/expo/index.mdx Outdated
Comment thread docs/platforms/react-native/guides/expo/index.mdx Outdated
Comment thread docs/platforms/react-native/guides/expo/index.mdx Outdated

@sfanahata sfanahata 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.

Something is weird with the side nav focus for Expo specifically. When I click a link from the quick start (/platforms/react-native/guides/expo/) to links (maybe exclusively in the manual setup directory?), the left nav doesn't respond/loses focus. It also looks like the SDK menu bounces back to react native vs staying on expo. This screenshot is on /platforms/react-native/manual-setup/expo/expo-updates/, but the left nav isn't showing that. I think main culprit is that for some reason the left nav is bouncing to react native vs staying on expo.

Image

antonis and others added 3 commits June 23, 2026 13:47
Address PR review feedback on the Expo guide and incorporate the Slack
discussion:

- Reword the intro per review suggestion
- Clarify the sentry-expo prerequisite (deprecated; requires Expo SDK 50+)
  and link it to the migration guide instead of a dead end
- Drop the Sentry Wizard repo link (keep the command below it)
- Reword the plugin step so it matches the snippet (plugins array in
  app.json, or withSentry in app.config.js/ts)
- Point the guide's internal links at guide-scoped URLs so the sidebar
  stays on Expo when navigating (fixes the nav "bounce" to React Native)
- Add an "Integrate Sentry with your EAS dashboard" section, porting the
  EAS deployment integration content, and cross-link it from
  /integrations/deployment/expo/

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Expo-specific pages previously lived in the shared common/ tree, so they
also showed up in the bare React Native sidebar. Move them under the Expo
guide so they only appear there, and link them from the related React
Native pages instead.

- Move into guides/expo/: manual-setup/expo/{eas-build-hooks,expo-updates,
  gradle}, migration/sentry-expo, sourcemaps/uploading/{expo,expo-advanced},
  tracing/instrumentation/{expo-router,expo-resources}
- Delete the old manual-setup/expo.mdx setup page (superseded by the guide
  landing) and redirect its URL to the guide
- Repoint links from bare-RN pages (index, sourcemaps, troubleshooting,
  tracing) to the guide-scoped Expo URLs
- Add redirects from the old platform URLs to the new guide URLs

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
…cker

The common/ restructure brought every React Native page into the PR's
link-check scope, surfacing three long-standing dead links:

- Metro bundling docs moved to metrobundler.dev
- facebook/metro and facebook/react-native repos moved to the react org

Update them to their current canonical URLs (all verified 200).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@antonis

antonis commented Jun 24, 2026

Copy link
Copy Markdown
Contributor Author

Something is weird with the side nav focus for Expo specifically.

It should be ok now 🤞

@antonis antonis requested a review from lucas-zimerman June 25, 2026 08:43

@sfanahata sfanahata 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 great!

@sfanahata

Copy link
Copy Markdown
Contributor

@antonis - looks like there are some conflicts, but the navigation now works, and content looks great!

# Conflicts:
#	docs/platforms/react-native/guides/expo/index.mdx
#	docs/platforms/react-native/guides/expo/tracing/instrumentation/expo-router.mdx
@antonis antonis merged commit fa1117d into master Jun 30, 2026
25 checks passed
@antonis antonis deleted the rn-expo-guide-spike branch June 30, 2026 08:22
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.

Extend https://docs.sentry.io/platforms/react-native/ with an Expo subpage

2 participants