Skip to content

[skill-drift] update(sentry-react-native-sdk): NavigationContainer wrapper + disableAutoUpload + Kotlin DSL#146

Merged
HazAT merged 1 commit into
mainfrom
skill-drift/sentry-react-native-sdk-skill-drift-update-sentry-react-native-s-1780044251
May 29, 2026
Merged

[skill-drift] update(sentry-react-native-sdk): NavigationContainer wrapper + disableAutoUpload + Kotlin DSL#146
HazAT merged 1 commit into
mainfrom
skill-drift/sentry-react-native-sdk-skill-drift-update-sentry-react-native-s-1780044251

Conversation

@github-actions
Copy link
Copy Markdown
Contributor

Warning

Auto-generated from external SDK content. Review all links and code suggestions before acting on them.

Summary

Updates sentry-react-native-sdk skill to reflect three new features from the upstream SDK:

  1. New Sentry.NavigationContainer wrapper (PR #6199, SDK ≥8.13.0) — Drop-in replacement for React Navigation's NavigationContainer that automatically wires up navigation tracking without manual ref management. Updated all React Navigation setup examples to show this as the recommended approach.

  2. disableAutoUpload Expo plugin option (PR #6195, SDK ≥8.13.0) — New config option to skip source map and dSYM uploads during local development builds. Documented in Expo plugin reference with usage examples.

  3. Kotlin DSL migration (PR #6119, SDK ≥8.13.0) — Android setup now uses sentry.gradle.kts (Kotlin DSL) instead of sentry.gradle (Groovy). The old .gradle file remains as a shim for backward compatibility. Updated Android setup instructions and troubleshooting.

Changes Made

  • Updated React Navigation setup section to show Sentry.NavigationContainer as the primary/recommended approach
  • Simplified Expo Router and standard Expo initialization examples (removed manual navigation integration setup)
  • Added disableAutoUpload option to Expo plugin configuration reference with examples
  • Updated Android bare RN setup to reference sentry.gradle.kts with backward-compatibility note
  • Updated troubleshooting section for Kotlin DSL

Verification

All three changes are mechanical documentation updates:

  • NavigationContainer is a new public API that simplifies existing functionality
  • disableAutoUpload is a new config key with boolean value
  • sentry.gradle.kts is backward-compatible (old file remains as shim)

No breaking changes — all existing code continues to work.

Source PRs

…apper + disableAutoUpload + Kotlin DSL

Automated drift-fix run.

Co-Authored-By: Claude (claude-sonnet-4-5) <noreply@anthropic.com>
navigationIntegration.registerNavigationContainer(navigationRef);
}}
>
<Sentry.NavigationContainer>
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Bug: Documentation suggests using <Sentry.NavigationContainer>, which will crash on supported SDK versions older than 8.13.0 where the component doesn't exist.
Severity: HIGH

Suggested Fix

Add a version caveat (e.g., "SDK ≥8.13.0 only") directly in the main setup examples where <Sentry.NavigationContainer> is used. Alternatively, use the manual <NavigationContainer ref={...}> approach in the main examples and present <Sentry.NavigationContainer> as a version-specific alternative.

Prompt for AI Agent
Review the code at the location below. A potential bug has been identified by an AI
agent. Verify if this is a real issue. If it is, propose a fix; if not, explain why it's
not valid.

Location: skills/sentry-react-native-sdk/SKILL.md#L270

Potential issue: The setup guide in `SKILL.md` recommends using
`<Sentry.NavigationContainer>` in its main examples for both standard Expo and bare
React Native. However, the documentation's minimum recommended SDK is `≥8.0.0`, while
the `<Sentry.NavigationContainer>` component only exists in SDK versions `≥8.13.0`.
Developers on SDK versions between 8.0.0 and 8.12.x who follow these setup instructions
will encounter a runtime `TypeError` crash because the component will be undefined.
While a version caveat exists in a separate section, its absence from the main setup
paths creates a trap for users.

Did we get this right? 👍 / 👎 to inform future reviews.

@HazAT HazAT merged commit 8f118f3 into main May 29, 2026
5 checks passed
@HazAT HazAT deleted the skill-drift/sentry-react-native-sdk-skill-drift-update-sentry-react-native-s-1780044251 branch May 29, 2026 10:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant