Skip to content

docs(react-native): Document SENTRY_PROJECT_ROOT for monorepo setups#17269

Open
antonis wants to merge 2 commits intomasterfrom
antonis/docs/sentry-project-root
Open

docs(react-native): Document SENTRY_PROJECT_ROOT for monorepo setups#17269
antonis wants to merge 2 commits intomasterfrom
antonis/docs/sentry-project-root

Conversation

@antonis
Copy link
Copy Markdown
Contributor

@antonis antonis commented Apr 7, 2026

DESCRIBE YOUR PR

Adds documentation for the new SENTRY_PROJECT_ROOT environment variable in the React Native manual setup guide.

This env var allows monorepo users (NX, Turborepo) to override the project root in Xcode build phase scripts, fixing incorrect path resolution caused by symlinked node_modules.

  • Added SENTRY_PROJECT_ROOT to both the source maps and debug symbols upload env var sections
  • Added a <Note> explaining when to use it

Companion SDK PR: getsentry/sentry-react-native#5961
Fixes: getsentry/sentry-react-native#2880

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#5961 is released

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

… setups

Adds SENTRY_PROJECT_ROOT to the environment variables list in both the
source maps and debug symbols upload sections of the React Native
manual setup guide.

Ref: getsentry/sentry-react-native#2880

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@vercel
Copy link
Copy Markdown

vercel bot commented Apr 7, 2026

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

Project Deployment Actions Updated (UTC)
sentry-docs Ready Ready Preview, Comment Apr 7, 2026 10:48am
1 Skipped Deployment
Project Deployment Actions Updated (UTC)
develop-docs Ignored Ignored Preview Apr 7, 2026 10:48am

Request Review

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
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.

CLI incorrectly resolves path to the Metro config in a NX monorepo

1 participant