feat(source-maps): flesh out React Native upload guidance - #263
Merged
Conversation
🧙 Wizard CIRun the Wizard CI and test your changes against wizard-workbench example apps by replying with a GitHub comment using one of the following commands: Test all apps:
Test all apps in a directory:
Test an individual app:
Show more apps
Results will be posted here when complete. |
ablaszkiewicz
marked this pull request as draft
July 22, 2026 10:30
Contributor
Author
|
Added native crash symbolication to the RN section (Expo |
ablaszkiewicz
force-pushed
the
ab/feat/react-native-source-maps
branch
from
July 23, 2026 06:58
f8fb113 to
93c9f55
Compare
This was referenced Jul 23, 2026
ablaszkiewicz
marked this pull request as ready for review
July 24, 2026 11:19
cat-ph
approved these changes
Jul 28, 2026
The wizard is flipping react-native to automatable in the error-tracking-upload-source-maps program. Split the shared React Native / Flutter line into a dedicated RN entry covering the two flows (Expo config plugin vs bare RN Gradle script + Xcode build phase), the global posthog-cli requirement, Release-only uploads, and the manual OTA upload; add RN credential and Release build/run command notes. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Extends the RN build-config example with the native symbol flows — Expo via the plugin's uploadNativeSymbols option, bare RN via the standalone iOS/Android examples — plus the runtime nativeCrashes pairing gotcha. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
The wizard agent added the bare Expo plugin string and dropped symbolication, leaning on the reference doc's 'optional' badge. State that the badge does not apply — enable uploadNativeSymbols with source inclusion per the reference — without duplicating the reference's exact config here. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…ol upload Symbol upload without errorTracking.autocapture.nativeCrashes (and the @posthog/react-native-plugin package it depends on) means native crashes are silently never reported. Make the agent enable the runtime half too. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…uidance The bare RN template only defines NODE_BINARY inside with-environment.sh, so the posthog-xcode.sh resolution token expanded to nothing and the phase failed with ': command not found' — the phase must source .xcode.env(.local) first. Credentials tip now points bare RN iOS at a POSTHOG_CLI_DOTENV_FILE user-defined build setting (covers bundle + dSYM phases, posthog-cli >= 0.8.4) and calls out the $(SRCROOT)/../.env anchor, since .env lives at the app root, not in ios/. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Source-map upload for React Native is Expo-only: chunk-ID injection relies on Expo's serialization pipeline, so a bare RN app uploads symbol sets that can never resolve runtime frames. The skill now tells the agent to abort with `bare react native not supported` (matched by the wizard's abort case) instead of wiring the Gradle script and Xcode phases by hand, and the credentials + build-command guidance is rewritten for the Expo CLI flow. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
… the wizard uses The wizard blocks bare React Native at detection, so the skill never sees one — drop the bare-RN unsupported note and its abort instruction. Also drop the OTA-bundle gotcha (the wizard never publishes OTA updates) and the direct-xcodebuild/gradlew credentials caveat (the wizard only builds through the Expo CLI). Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…le prop for credentials posthog-react-native 4.60.0 shipped the `dotenvFile` option on the Expo config plugin: at prebuild it wires the path into every upload hook as POSTHOG_CLI_DOTENV_FILE (Xcode build setting on iOS, posthog.dotenvFile gradle property on Android). The credentials tip now tells the agent to set `"dotenvFile": ".env"` on the plugin entry instead of relying on the Expo CLI's .env auto-load, which only covers builds the Expo CLI itself spawns. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…prose Keep only agent-actionable instructions and guardrails; drop mechanism explanations, duplicated Release-only notes, and consequence prose. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
ablaszkiewicz
force-pushed
the
ab/feat/react-native-source-maps
branch
from
July 29, 2026 06:43
ce51412 to
3a9d11f
Compare
posthog.com's "migrate Logs docs to the new IA" (#18964) moved /docs/logs/debug-logs-mcp to /docs/logs/surfaces/mcp. A Vercel redirect covers the HTML path, but the .md variant is only emitted for slugs with a built page — generateRawMarkdownPages skips anything without public/<slug>/index.html — so debug-logs-mcp.md now 404s and the build hard-fails while generating the logs skills. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Related PRs
Part of the React Native source-map upload rollout:
What
Companion to PostHog/wizard#941, which flips
react-nativeto automatable in theerror-tracking-upload-source-mapsprogram. The skill variant already publishes; this fleshes out the template's RN guidance so the agent lands the right flow first try:posthog-react-native/expo+getPostHogExpoConfigmetro config) vs bare RN (SDK'stooling/posthog.gradlein the app module +posthog-xcode.shin the "Bundle React Native code and images" phase), plus the Release-only upload, the globalposthog-cli(v0.7.8+, wizard-installed) rule, and the manual OTA upload (posthog-cli hermes upload --directory dist).POSTHOG_CLI_*for both native hooks, same API-host rule as iOS).npm test(137) andnpm run buildgreen;error-tracking-upload-source-maps-react-native.zippresent indist/skills/.🤖 Generated with Claude Code