Skip to content

chore(error-tracking): guide Flutter Dart AOT symbol uploads - #445

Merged
hpouillot merged 1 commit into
mainfrom
docs/flutter-aot-symbol-upload
Oct 28, 2026
Merged

hpouillot merged 1 commit into
mainfrom
docs/flutter-aot-symbol-upload

Conversation

@hpouillot

Copy link
Copy Markdown
Contributor

Problem

Flutter app developers following Wizard's upload guidance are told Dart symbols cannot be uploaded. Release AOT stack traces then lack the available Dart symbolication path.

Changes

  • Wizard's Flutter upload skill now guides release builds through build-matched Dart .symbols uploads on Android and iOS.
  • App source upload remains optional through --include-source --source-root ./lib; web and native crash uploads remain separate.
  • The setup guidance requires posthog_flutter 5.58.0+ and the upcoming posthog-cli 0.19.0+.
  • Verification uses the built release artifact rather than rebuilding it with flutter run --release.

How did you test this code?

  • pnpm test and pnpm build completed. Inspected the generated Flutter skill ZIP for the AOT steps and version requirements.
  • No remote symbol upload or device test was run.

Test rationale: Existing skill-expansion tests cover Flutter variant registration. This prose change adds no generator behavior to test.

Release status

  • No feature flag controls this change

Docs update

The Flutter upload guide still covers web and native symbols. In-app onboarding #124824 documents the Dart upload commands separately. Keep this PR in draft until posthog-cli 0.19.0 is published.

🤖 Agent context

Autonomy: Human-driven (agent-assisted)

Agent: pi, gpt-6-sol

The change updates context-mill guidance; Wizard's routing needs no code change. Skills invoked: /writing-skills, /writing-user-facing-copy, /writing-tests, /writing-pr-descriptions.

@hpouillot hpouillot self-assigned this Oct 28, 2026
@github-actions

Copy link
Copy Markdown

🧙 Wizard CI

Run 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:

  • /wizard-ci all

Test all apps in a directory:

  • /wizard-ci ai-observability
  • /wizard-ci basic-integration
  • /wizard-ci feature-flags
  • /wizard-ci mcp-analytics
  • /wizard-ci replay-vision
  • /wizard-ci revenue
  • /wizard-ci self-driving
  • /wizard-ci warehouse
  • /wizard-ci warehouse-seeded

Test an individual app:

  • /wizard-ci ai-observability/anthropic
  • /wizard-ci ai-observability/google-adk
  • /wizard-ci ai-observability/groq
Show more apps
  • /wizard-ci ai-observability/manual-capture
  • /wizard-ci ai-observability/openai
  • /wizard-ci ai-observability/openai-agents
  • /wizard-ci ai-observability/opentelemetry
  • /wizard-ci ai-observability/vercel-ai
  • /wizard-ci basic-integration/android
  • /wizard-ci basic-integration/angular
  • /wizard-ci basic-integration/astro
  • /wizard-ci basic-integration/django
  • /wizard-ci basic-integration/fastapi
  • /wizard-ci basic-integration/flask
  • /wizard-ci basic-integration/flutter
  • /wizard-ci basic-integration/javascript-node
  • /wizard-ci basic-integration/javascript-web
  • /wizard-ci basic-integration/laravel
  • /wizard-ci basic-integration/next-js
  • /wizard-ci basic-integration/nuxt
  • /wizard-ci basic-integration/python
  • /wizard-ci basic-integration/rails
  • /wizard-ci basic-integration/react-native
  • /wizard-ci basic-integration/react-router
  • /wizard-ci basic-integration/sveltekit
  • /wizard-ci basic-integration/swift
  • /wizard-ci basic-integration/tanstack-router
  • /wizard-ci basic-integration/tanstack-start
  • /wizard-ci basic-integration/vue
  • /wizard-ci feature-flags/django
  • /wizard-ci feature-flags/next-js
  • /wizard-ci mcp-analytics/custom-dispatcher
  • /wizard-ci mcp-analytics/typescript-sdk
  • /wizard-ci replay-vision/javascript-node
  • /wizard-ci replay-vision/next-js
  • /wizard-ci replay-vision/react-vite
  • /wizard-ci revenue/stripe
  • /wizard-ci self-driving/astro
  • /wizard-ci self-driving/fastapi
  • /wizard-ci self-driving/nuxt
  • /wizard-ci self-driving/react-router
  • /wizard-ci self-driving/sveltekit
  • /wizard-ci warehouse/monorepo-env
  • /wizard-ci warehouse/multi-source-next
  • /wizard-ci warehouse/stripe-node
  • /wizard-ci warehouse/zero-source
  • /wizard-ci warehouse-seeded/next-stripe
  • /wizard-ci warehouse-seeded/next-stripe-declined

Test against a wizard branch:

  • /wizard-ci all wizard:my-branch

Add wizard:<branch> to any command above to pin the wizard branch. It defaults to main.

Results will be posted here when complete.

@hpouillot
hpouillot marked this pull request as ready for review October 28, 2026 14:24
@hpouillot
hpouillot requested a review from a team as a code owner October 28, 2026 14:24
@ablaszkiewicz

Copy link
Copy Markdown
Contributor

@hpouillot add mcp-publish label - this makes it update the thing actually

@hpouillot
hpouillot merged commit b699b20 into main Oct 28, 2026
18 checks passed
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.

2 participants