feat(source-maps): Flutter upload guidance - #281
Merged
Conversation
Flesh out the Flutter variant of error-tracking-upload-source-maps so the agent can wire all three of Flutter's upload paths. Flutter compiles one Dart source through three different compilers, so each platform has its own symbol artifact: dart2js source maps for web, R8 mapping files for Android, dSYMs for iOS. The web path runs posthog-cli over build/web; the native paths delegate to the existing Android and iOS examples, with the Flutter-specific deltas called out. Those deltas are what the delegation would otherwise get wrong: - Gradle's root project is android/ and Xcode's SRCROOT is ios/, so both native paths reach up for the project-root .env. - Plugin versions live in android/settings.gradle.kts, so the plugin is declared there and applied versionless in the app module. - Flutter always shrinks release builds, so the Android example's isMinifyEnabled step is skipped. - Flutter is always CocoaPods, fixing the upload-symbols.sh path. Also pins the Gradle plugin to 1.4.0 — the Android reference carries a "$version" placeholder, and an agent run resolved it to a nonexistent 3.19.0 by reusing the SDK's version line. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
🧙 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. |
The Flutter test-affordance bullet said "verifies the web path only", so the agent produced a web-only verification step and left Android and iOS untested. Give a flow per wired platform, and state what the button can't prove: on Android and iOS it raises a Dart exception, which needs no symbol set because mapping.txt and dSYMs cover the Java/Kotlin and Swift layers, not compiled Dart. Verify those by the symbol set appearing instead. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Drop what the agent doesn't act on: the dart2js sourcesContent note, the Dart-vs-native symbolication explanation in the test step, the npx-fallback gotcha (already covered by the Android/iOS bullets it delegates to), and a duplicated POSTHOG_CLI_HOST rule. Stop pinning the Gradle plugin to 1.4.0 — the Android bullet already says never to reuse the SDK version, so follow that instead of hardcoding. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
hpouillot
approved these changes
Jul 27, 2026
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 Flutter source-map upload rollout:
What
Companion to PostHog/wizard#985. Flutter compiles one Dart source through three compilers, so each platform has its own symbol artifact — the web path runs
posthog-clioverbuild/web, the native paths delegate to the existing Android and iOS examples.Calls out the Flutter deltas that delegation would otherwise get wrong: Gradle's root is
android/and Xcode'sSRCROOTisios/, so both reach up for the project-root.env; the plugin is declared inandroid/settings.gradle.kts;isMinifyEnabledis skipped (Flutter always shrinks release builds); CocoaPods is always theupload-symbols.shpath.Also pins the Gradle plugin to
1.4.0— the Android reference carries a$versionplaceholder, and an agent run resolved it to a nonexistent3.19.0.🤖 Generated with Claude Code