chore(error-tracking): document Flutter Dart symbol uploads by hpouillot · Pull Request #124824 · PostHog/posthog

hpouillot · 2026-10-28T13:32:18Z

Problem

Flutter developers see onboarding that says obfuscated Dart traces, source context, and background isolate capture are unavailable. The backend and Flutter isolate listener have since merged.

Changes

Flutter onboarding now shows Android and iOS release-build commands followed by matching Dart symbol uploads.
The Flutter error-tracking install snippet now uses posthog_flutter 5.58.0; other Flutter guides keep their current version.
Source context stays opt-in through --include-source --source-root ./lib; the default upload includes symbols only.
Background-isolate guidance explains explicit addPostHogErrorListener() registration instead of claiming that capture is unsupported.
The remaining limitations distinguish obfuscated exception names from resolved stack frames.

Before

After

How did you test this code?

Rendered the Flutter onboarding flow locally at 1280px and 760px, including the isolate instructions and opt-in upload commands.
Ran pnpm --filter=@posthog/frontend typescript:check, targeted Oxlint and Oxfmt checks, and hogli ci:preflight --fix.

Test rationale: No new test is needed for onboarding copy; the rendered flow and narrow layout were checked in the running app.

Live iOS AOT capture was not verified; no physical device was available.

Release status

No feature flag controls this change

Docs update

Updates the existing Flutter error-tracking onboarding guide. The matching @posthog/cli 0.19.0 is published.

🤖 Agent context

Autonomy: Human-driven (agent-assisted)

Agent: Pi, gpt-6-sol

The /writing-user-facing-copy, /writing-tests, /writing-pr-descriptions, /running-ci-preflight, and /pr skills shaped this change. The isolate guidance follows the merged Flutter listener API. The screenshots contain local onboarding text only, without customer data or credentials.

trunk-io · 2026-10-28T13:32:23Z

😎 Merged successfully - details.

github-actions · 2026-10-28T13:35:41Z

🤖 CI report

✅ Trunk lane — non-backend lane

This PR is assigned to the non-backend lane. It does not run backend Python tests and may merge in parallel with PRs in other lanes.

✅ Duplication (Python) — clean

New Python code duplication introduced by this branch. Fails at 70+ tokens in app code, or 150+ tokens when both copies live in test files. Advisory while the gate proves itself: extract a shared helper instead of copying.

✅ Duplication (TypeScript) — clean

New TypeScript code duplication introduced by this branch. Fails at 70+ tokens in app code, or 150+ tokens when both copies live in test files. Advisory while the gate proves itself: extract a shared helper instead of copying.

⚠️

Bundle size — 🔺 +2.8 KiB (+0.0%)

Uncompressed size of every built .js bundle, compared against the base branch.

Total: 77.18 MiB · 🔺 +2.8 KiB (+0.0%)

File	Size	Δ vs base
`posthog-app/src/scenes/onboarding/Onboarding.js`	786.1 KiB	🔺 +2.7 KiB (+0.3%)

_{Posted automatically by build-bundle-size-report · uncompressed bytes from dist-report}

⚠️

Eager graph — 3 over budget

How much code each root ships on the eager path — downloaded and parsed before the surface is interactive. Measured from the esbuild output chunks (post-tree-shake, static imports only); lazy import() / React.lazy chunks are not counted.

Root	Eager (shipped)	Δ vs base	Budget
entry (logged-out pages, app bootstrap) `src/index.tsx`	1.03 MiB · 25 files	no change	`█████████░` 90.1% of 1.14 MiB
logged-out boot: index + App + bootApp (preloaded by every page, including /login) `src/index.tsx + src/scenes/App.tsx + src/scenes/bootApp.ts`	2.99 MiB · 621 files	no change	`██████████` 98.7% of 3.03 MiB
🟡 authenticated shell (every logged-in page) `src/scenes/AuthenticatedShell.tsx`	7.61 MiB · 2,569 files	no change	`██████████` 101.5% of 7.50 MiB
dashboard scene `src/scenes/dashboard/Dashboard.tsx`	9.98 MiB · 3,739 files	no change	`██████████` 99.7% of 10.01 MiB
🟡 today home path `src/scenes/AuthenticatedShell.tsx + src/scenes/project-homepage/ProjectHomepage.tsx + src/scenes/project-homepage/today/TodayHome.tsx`	7.79 MiB · 2,662 files	no change	`██████████` 100.7% of 7.74 MiB
🟡 AI-first home path `src/scenes/AuthenticatedShell.tsx + src/scenes/project-homepage/ProjectHomepage.tsx + src/scenes/project-homepage/ai-first/AiFirstHomepage.tsx`	8.04 MiB · 2,655 files	no change	`██████████` 101.7% of 7.91 MiB
events scene `src/scenes/activity/explore/EventsScene.tsx`	9.42 MiB · 3,517 files	no change	`██████████` 98.3% of 9.59 MiB
web analytics scene `src/scenes/web-analytics/WebAnalyticsScene.tsx`	10.36 MiB · 3,767 files	no change	`██████████` 95.7% of 10.83 MiB
replay detail scene `src/scenes/session-recordings/detail/SessionRecordingDetail.tsx`	8.46 MiB · 3,110 files	no change	`█████████░` 89.3% of 9.47 MiB

🟢 node_modules/monaco-editor/ stays out of src/index.tsx
🟢 src/lib/components/ActivityLog/describers stays out of src/index.tsx
🟢 node_modules/@posthog/brand/dist/generated/hoggies/svg/ stays out of src/index.tsx
🟢 node_modules/@posthog/brand/dist/generated/hoggies/components/ stays out of src/index.tsx
🟢 node_modules/monaco-editor/ stays out of src/index.tsx + src/scenes/App.tsx + src/scenes/bootApp.ts
🟢 src/layout/navigation-3000/navigationLogic.tsx stays out of src/index.tsx + src/scenes/App.tsx + src/scenes/bootApp.ts
🟢 src/scenes/dashboard/dashboardLogic.tsx stays out of src/index.tsx + src/scenes/App.tsx + src/scenes/bootApp.ts
🟢 src/lib/lemon-ui/LemonMarkdown/ stays out of src/index.tsx + src/scenes/App.tsx + src/scenes/bootApp.ts
🟢 src/lib/components/RichContentEditor/ stays out of src/index.tsx + src/scenes/App.tsx + src/scenes/bootApp.ts
🟢 src/lib/components/CodeSnippet/ stays out of src/index.tsx + src/scenes/App.tsx + src/scenes/bootApp.ts
🟢 src/taxonomy/core-filter-definitions-by-group.json stays out of src/index.tsx + src/scenes/App.tsx + src/scenes/bootApp.ts
🟢 node_modules/zod/ stays out of src/index.tsx + src/scenes/App.tsx + src/scenes/bootApp.ts
🟢 src/scenes/billing/billingLogic.tsx stays out of src/index.tsx + src/scenes/App.tsx + src/scenes/bootApp.ts
🟢 src/lib/components/ProductEmptyState/productSetupPreloadLogic.ts stays out of src/index.tsx + src/scenes/App.tsx + src/scenes/bootApp.ts
🟢 node_modules/monaco-editor/ stays out of src/scenes/AuthenticatedShell.tsx
🟢 src/lib/components/ActivityLog/describers stays out of src/scenes/AuthenticatedShell.tsx
🟢 products/dashboards/frontend/widgets/previews/ stays out of src/scenes/AuthenticatedShell.tsx
🟢 src/scenes/session-recordings/player/sessionRecordingPlayerLogic.ts stays out of src/scenes/AuthenticatedShell.tsx
🟢 products/wizard/frontend/runs/WizardRunDetailsDrawer.tsx stays out of src/scenes/AuthenticatedShell.tsx
🟢 src/layout/today/TodayShell.tsx stays out of src/scenes/AuthenticatedShell.tsx
🟢 src/layout/today/TodayContextPanelFloating.tsx stays out of src/scenes/AuthenticatedShell.tsx
🟢 src/layout/today/TodaySidePanel.tsx stays out of src/scenes/AuthenticatedShell.tsx
🟢 src/layout/today/TodayTopBar.tsx stays out of src/scenes/AuthenticatedShell.tsx
🟢 src/layout/today/todayRailItems.tsx stays out of src/scenes/AuthenticatedShell.tsx
🟢 zod/v4/locales/de.js stays out of src/scenes/AuthenticatedShell.tsx
🟢 node_modules/@posthog/brand/dist/generated/hoggies/svg/ stays out of src/scenes/AuthenticatedShell.tsx
🟢 node_modules/@posthog/brand/dist/generated/hoggies/components/ stays out of src/scenes/AuthenticatedShell.tsx
🟢 src/scenes/session-recordings/playlist/SessionRecordingsPlaylist.tsx stays out of src/scenes/dashboard/Dashboard.tsx
🟢 src/scenes/web-analytics/tiles/WebAnalyticsTile.tsx stays out of src/scenes/dashboard/Dashboard.tsx
🟢 src/queries/validators.js stays out of src/scenes/dashboard/Dashboard.tsx
🟢 src/scenes/project-homepage/ai-first/AiFirstHomepage.tsx stays out of src/scenes/AuthenticatedShell.tsx + src/scenes/project-homepage/ProjectHomepage.tsx + src/scenes/project-homepage/today/TodayHome.tsx
🟢 src/scenes/project-homepage/today/TodayReportPage.tsx stays out of src/scenes/AuthenticatedShell.tsx + src/scenes/project-homepage/ProjectHomepage.tsx + src/scenes/project-homepage/today/TodayHome.tsx
🟢 src/queries/Query/Query.tsx stays out of src/scenes/AuthenticatedShell.tsx + src/scenes/project-homepage/ProjectHomepage.tsx + src/scenes/project-homepage/today/TodayHome.tsx
🟢 packages/quill/packages/charts/ stays out of src/scenes/AuthenticatedShell.tsx + src/scenes/project-homepage/ProjectHomepage.tsx + src/scenes/project-homepage/today/TodayHome.tsx
🟢 products/posthog_ai/frontend/components/tool/widgets/VisualizationWidget.tsx stays out of src/scenes/AuthenticatedShell.tsx + src/scenes/project-homepage/ProjectHomepage.tsx + src/scenes/project-homepage/ai-first/AiFirstHomepage.tsx
🟢 products/posthog_ai/frontend/components/tool/widgets/RecordingsWidget.tsx stays out of src/scenes/AuthenticatedShell.tsx + src/scenes/project-homepage/ProjectHomepage.tsx + src/scenes/project-homepage/ai-first/AiFirstHomepage.tsx
🟢 src/queries/Query/Query.tsx stays out of src/scenes/AuthenticatedShell.tsx + src/scenes/project-homepage/ProjectHomepage.tsx + src/scenes/project-homepage/ai-first/AiFirstHomepage.tsx
🟢 products/posthog_ai/frontend/api/primitives.ts stays out of src/scenes/AuthenticatedShell.tsx + src/scenes/project-homepage/ProjectHomepage.tsx + src/scenes/project-homepage/ai-first/AiFirstHomepage.tsx
🟢 src/scenes/notebooks/Notebook/notebookLogic.ts stays out of src/scenes/AuthenticatedShell.tsx + src/scenes/project-homepage/ProjectHomepage.tsx + src/scenes/project-homepage/ai-first/AiFirstHomepage.tsx
🟢 src/scenes/session-recordings/playlist/SessionRecordingsPlaylist.tsx stays out of src/scenes/activity/explore/EventsScene.tsx
🟢 src/scenes/web-analytics/tiles/WebAnalyticsTile.tsx stays out of src/scenes/activity/explore/EventsScene.tsx
🟢 src/queries/validators.js stays out of src/scenes/activity/explore/EventsScene.tsx
🟢 src/scenes/web-analytics/LiveMetricsDashboard/LiveWebAnalyticsMetrics.tsx stays out of src/scenes/web-analytics/WebAnalyticsScene.tsx
🟢 products/product_analytics/frontend/insights/trends/WorldMap/countryVectors.tsx stays out of src/scenes/web-analytics/WebAnalyticsScene.tsx
🟢 src/scenes/settings/SettingsMap.tsx stays out of src/scenes/session-recordings/detail/SessionRecordingDetail.tsx
🟢 @jspm/core/nodelibs/browser/fs stays out of src/scenes/session-recordings/detail/SessionRecordingDetail.tsx

Largest files eagerly shipped from src/index.tsx

Size	File
126.8 KiB	`../node_modules/.pnpm/[email protected][email protected]/node_modules/react-dom/cjs/react-dom.production.min.js`
24.6 KiB	`../node_modules/.pnpm/[email protected]/node_modules/buffer/index.js`
6.3 KiB	`../node_modules/.pnpm/[email protected]/node_modules/react/cjs/react.production.min.js`
4.7 KiB	`../node_modules/.pnpm/@[email protected]/node_modules/@jspm/core/nodelibs/browser/process.js`
4.0 KiB	`../node_modules/.pnpm/[email protected]/node_modules/scheduler/cjs/scheduler.production.min.js`
1.7 KiB	`src/index.tsx`
1.7 KiB	`../node_modules/.pnpm/[email protected]/node_modules/base64-js/index.js`
1.7 KiB	`src/lib/utils/bootTiming.ts`
1.2 KiB	`src/RootErrorBoundary.tsx`
949 B	`src/scenes/ChunkLoadErrorBoundary.tsx`

Largest files eagerly shipped from src/index.tsx + src/scenes/App.tsx + src/scenes/bootApp.ts

Size	File
323.1 KiB	`../node_modules/.pnpm/[email protected]_@[email protected][email protected]/node_modules/posthog-js/dist/module.mjs`
217.5 KiB	`../node_modules/.pnpm/@[email protected][email protected][email protected][email protected]/node_modules/@posthog/icons/dist/posthog-icons.es.js`
126.8 KiB	`../node_modules/.pnpm/[email protected][email protected]/node_modules/react-dom/cjs/react-dom.production.min.js`
102.5 KiB	`src/products.tsx`
86.2 KiB	`src/lib/api.ts`
68.3 KiB	`src/lib/lemon-ui/icons/icons.tsx`
41.9 KiB	`../node_modules/.pnpm/@[email protected][email protected][email protected][email protected]/node_modules/@dnd-kit/core/dist/core.esm.js`
36.4 KiB	`../node_modules/.pnpm/[email protected]_patch_hash=139b8d1f1304f9d9da452a9a1244c94ea679dbcb85687d8999563146879fb6f5_react@18.3.1/node_modules/kea/lib/index.cjs.js`
27.0 KiB	`../node_modules/.pnpm/[email protected]/node_modules/tailwind-merge/dist/bundle-mjs.mjs`
24.6 KiB	`../node_modules/.pnpm/[email protected]/node_modules/buffer/index.js`

Largest files eagerly shipped from src/scenes/AuthenticatedShell.tsx

Size	File
323.1 KiB	`../node_modules/.pnpm/[email protected]_@[email protected][email protected]/node_modules/posthog-js/dist/module.mjs`
286.4 KiB	`src/taxonomy/core-filter-definitions-by-group.json`
239.9 KiB	`../packages/quill/packages/quill/dist/index.js`
217.5 KiB	`../node_modules/.pnpm/@[email protected][email protected][email protected][email protected]/node_modules/@posthog/icons/dist/posthog-icons.es.js`
153.8 KiB	`../node_modules/.pnpm/[email protected]/node_modules/re2js/build/index.esm.js`
126.8 KiB	`../node_modules/.pnpm/[email protected][email protected]/node_modules/react-dom/cjs/react-dom.production.min.js`
102.5 KiB	`src/products.tsx`
94.5 KiB	`../node_modules/.pnpm/@[email protected]_@[email protected]/node_modules/@tiptap/core/dist/index.js`
92.5 KiB	`../node_modules/.pnpm/[email protected]/node_modules/prosemirror-view/dist/index.js`
86.2 KiB	`src/lib/api.ts`

Largest files eagerly shipped from src/scenes/dashboard/Dashboard.tsx

Size	File
323.1 KiB	`../node_modules/.pnpm/[email protected]_@[email protected][email protected]/node_modules/posthog-js/dist/module.mjs`
286.4 KiB	`src/taxonomy/core-filter-definitions-by-group.json`
239.9 KiB	`../packages/quill/packages/quill/dist/index.js`
217.5 KiB	`../node_modules/.pnpm/@[email protected][email protected][email protected][email protected]/node_modules/@posthog/icons/dist/posthog-icons.es.js`
153.8 KiB	`../node_modules/.pnpm/[email protected]/node_modules/re2js/build/index.esm.js`
144.1 KiB	`../packages/quill/packages/primitives/dist/index.js`
126.8 KiB	`../node_modules/.pnpm/[email protected][email protected]/node_modules/react-dom/cjs/react-dom.production.min.js`
102.5 KiB	`src/products.tsx`
94.5 KiB	`../node_modules/.pnpm/@[email protected]_@[email protected]/node_modules/@tiptap/core/dist/index.js`
92.5 KiB	`../node_modules/.pnpm/[email protected]/node_modules/prosemirror-view/dist/index.js`

Largest files eagerly shipped from

src/scenes/AuthenticatedShell.tsx + src/scenes/project-homepage/ProjectHomepage.tsx + src/scenes/project-homepage/today/TodayHome.tsx

Size	File
323.1 KiB	`../node_modules/.pnpm/[email protected]_@[email protected][email protected]/node_modules/posthog-js/dist/module.mjs`
286.4 KiB	`src/taxonomy/core-filter-definitions-by-group.json`
239.9 KiB	`../packages/quill/packages/quill/dist/index.js`
217.5 KiB	`../node_modules/.pnpm/@[email protected][email protected][email protected][email protected]/node_modules/@posthog/icons/dist/posthog-icons.es.js`
153.8 KiB	`../node_modules/.pnpm/[email protected]/node_modules/re2js/build/index.esm.js`
126.8 KiB	`../node_modules/.pnpm/[email protected][email protected]/node_modules/react-dom/cjs/react-dom.production.min.js`
102.5 KiB	`src/products.tsx`
94.5 KiB	`../node_modules/.pnpm/@[email protected]_@[email protected]/node_modules/@tiptap/core/dist/index.js`
92.5 KiB	`../node_modules/.pnpm/[email protected]/node_modules/prosemirror-view/dist/index.js`
86.2 KiB	`src/lib/api.ts`

Largest files eagerly shipped from

src/scenes/AuthenticatedShell.tsx + src/scenes/project-homepage/ProjectHomepage.tsx + src/scenes/project-homepage/ai-first/AiFirstHomepage.tsx

Size	File
323.1 KiB	`../node_modules/.pnpm/[email protected]_@[email protected][email protected]/node_modules/posthog-js/dist/module.mjs`
286.4 KiB	`src/taxonomy/core-filter-definitions-by-group.json`
239.9 KiB	`../packages/quill/packages/quill/dist/index.js`
217.5 KiB	`../node_modules/.pnpm/@[email protected][email protected][email protected][email protected]/node_modules/@posthog/icons/dist/posthog-icons.es.js`
153.8 KiB	`../node_modules/.pnpm/[email protected]/node_modules/re2js/build/index.esm.js`
144.1 KiB	`../packages/quill/packages/primitives/dist/index.js`
126.8 KiB	`../node_modules/.pnpm/[email protected][email protected]/node_modules/react-dom/cjs/react-dom.production.min.js`
102.5 KiB	`src/products.tsx`
94.5 KiB	`../node_modules/.pnpm/@[email protected]_@[email protected]/node_modules/@tiptap/core/dist/index.js`
92.5 KiB	`../node_modules/.pnpm/[email protected]/node_modules/prosemirror-view/dist/index.js`

Largest files eagerly shipped from src/scenes/activity/explore/EventsScene.tsx

Size	File
323.1 KiB	`../node_modules/.pnpm/[email protected]_@[email protected][email protected]/node_modules/posthog-js/dist/module.mjs`
286.4 KiB	`src/taxonomy/core-filter-definitions-by-group.json`
239.9 KiB	`../packages/quill/packages/quill/dist/index.js`
217.5 KiB	`../node_modules/.pnpm/@[email protected][email protected][email protected][email protected]/node_modules/@posthog/icons/dist/posthog-icons.es.js`
153.8 KiB	`../node_modules/.pnpm/[email protected]/node_modules/re2js/build/index.esm.js`
144.1 KiB	`../packages/quill/packages/primitives/dist/index.js`
126.8 KiB	`../node_modules/.pnpm/[email protected][email protected]/node_modules/react-dom/cjs/react-dom.production.min.js`
102.5 KiB	`src/products.tsx`
94.5 KiB	`../node_modules/.pnpm/@[email protected]_@[email protected]/node_modules/@tiptap/core/dist/index.js`
92.5 KiB	`../node_modules/.pnpm/[email protected]/node_modules/prosemirror-view/dist/index.js`

Largest files eagerly shipped from src/scenes/web-analytics/WebAnalyticsScene.tsx

Size	File
323.1 KiB	`../node_modules/.pnpm/[email protected]_@[email protected][email protected]/node_modules/posthog-js/dist/module.mjs`
286.4 KiB	`src/taxonomy/core-filter-definitions-by-group.json`
239.9 KiB	`../packages/quill/packages/quill/dist/index.js`
217.5 KiB	`../node_modules/.pnpm/@[email protected][email protected][email protected][email protected]/node_modules/@posthog/icons/dist/posthog-icons.es.js`
187.9 KiB	`src/queries/validators.js`
153.8 KiB	`../node_modules/.pnpm/[email protected]/node_modules/re2js/build/index.esm.js`
144.1 KiB	`../packages/quill/packages/primitives/dist/index.js`
126.8 KiB	`../node_modules/.pnpm/[email protected][email protected]/node_modules/react-dom/cjs/react-dom.production.min.js`
102.5 KiB	`src/products.tsx`
94.5 KiB	`../node_modules/.pnpm/@[email protected]_@[email protected]/node_modules/@tiptap/core/dist/index.js`

Largest files eagerly shipped from src/scenes/session-recordings/detail/SessionRecordingDetail.tsx

Size	File
323.1 KiB	`../node_modules/.pnpm/[email protected]_@[email protected][email protected]/node_modules/posthog-js/dist/module.mjs`
316.1 KiB	`../node_modules/.pnpm/[email protected]_@[email protected][email protected]/node_modules/posthog-js/dist/rrweb.js`
286.4 KiB	`src/taxonomy/core-filter-definitions-by-group.json`
239.9 KiB	`../packages/quill/packages/quill/dist/index.js`
217.5 KiB	`../node_modules/.pnpm/@[email protected][email protected][email protected][email protected]/node_modules/@posthog/icons/dist/posthog-icons.es.js`
153.8 KiB	`../node_modules/.pnpm/[email protected]/node_modules/re2js/build/index.esm.js`
126.8 KiB	`../node_modules/.pnpm/[email protected][email protected]/node_modules/react-dom/cjs/react-dom.production.min.js`
102.5 KiB	`src/products.tsx`
94.5 KiB	`../node_modules/.pnpm/@[email protected]_@[email protected]/node_modules/@tiptap/core/dist/index.js`
92.5 KiB	`../node_modules/.pnpm/[email protected]/node_modules/prosemirror-view/dist/index.js`

_{Posted automatically by check-eager-graph · sizes are eager output bytes (shipped, post-tree-shake) from the esbuild metafile · part of #32479}

✅ Toolbar bundle — eager 2.33 MiB within budget

What the toolbar ships to customer pages, measured from the esbuild output (minified, post-tree-shake). The eager set is the entry plus everything statically imported from it — fetched before any feature runs; deferred chunks load lazily. The eager guardrail is 5.72 MiB. Each output file must also stay below 10 MB, where CloudFront stops compressing it. The module boundary is enforced separately by check-toolbar-graph.

Metric	Size	Δ vs base	Budget
Eager (shipped) entry + static imports	2.33 MiB · 18 files	no change	`████░░░░░░` 40.7% of 5.72 MiB
Deferred (lazy)	2.11 MiB · 40 files	no change	n/a — loads on demand
Loader `dist/toolbar.js`	1.2 KiB	no change	`█░░░░░░░░░` 6.0% of 19.5 KiB

Largest eagerly-shipped chunks

Size	File
937.4 KiB	`dist/toolbar/toolbar-app-TKVDLOT2.css`
695.9 KiB	`dist/toolbar/chunk-chunk-6F435JDI.js`
260.0 KiB	`dist/toolbar/chunk-chunk-YR24IQWU.js`
131.8 KiB	`dist/toolbar/chunk-chunk-FDH2IBXT.js`
130.4 KiB	`dist/toolbar/chunk-chunk-XT7WYNG2.js`
75.7 KiB	`dist/toolbar/toolbar-app-4VTG45UY.js`
69.0 KiB	`dist/toolbar/chunk-chunk-TSAL54PB.js`
35.6 KiB	`dist/toolbar/chunk-chunk-OPL4SKA4.js`
21.7 KiB	`dist/toolbar/chunk-chunk-3OPAVBPF.js`
6.8 KiB	`dist/toolbar/chunk-chunk-DV7IWQNF.js`

_{Posted automatically by check-toolbar-size · sizes are toolbar output bytes (shipped, post-tree-shake) from the esbuild metafile}

✅ Dist folder size — 🔺 +16.6 KiB (+0.0%)

Total size of the built frontend/dist folder (all assets), compared against the base branch.

Total: 975.03 MiB · 🔺 +16.6 KiB (+0.0%)

JamesPatrickGill · 2026-10-28T14:08:25Z

+
+export const getFlutterInstallSteps = (
+    ctx: OnboardingComponentsContext,
+    flutterSdkVersion: string = DEFAULT_FLUTTER_SDK_VERSION


suggestion: getFlutterInstallSteps and getFlutterSteps take the SDK version as a bare string. React Native and iOS install helpers in this folder take an options object instead. React Native uses options?: { minVersion?: string } and calls it as getReactNativeStepsPA(ctx, { minVersion: '4.44.0' }). The error-tracking call getFlutterStepsPA(ctx, FLUTTER_ERROR_TRACKING_MIN_VERSION) uses a bare string, so anyone grepping for minVersion to find version-pinned guides will miss it.

Match the React Native shape:

export const getFlutterInstallSteps = ( ctx: OnboardingComponentsContext, options?: { minVersion?: string } ): StepDefinition[] => { const flutterSdkVersion = options?.minVersion ?? DEFAULT_FLUTTER_SDK_VERSION

Then pass options through getFlutterSteps, and call it as getFlutterStepsPA(ctx, { minVersion: FLUTTER_ERROR_TRACKING_MIN_VERSION }) in docs/onboarding/error-tracking/flutter.tsx:11.

🤖 Updated the Flutter install helpers to accept { minVersion } and pass the options object through. Error tracking now uses the shared options pattern in 85529e3.

JamesPatrickGill · 2026-10-28T14:08:25Z

+                />
+                <Markdown>
+                    {dedent`
+                        Upload the matching \`.symbols\` files from your app's root directory. Sign in with \`posthog-cli login\`, or set \`POSTHOG_CLI_API_KEY\` and \`POSTHOG_CLI_PROJECT_ID\` in CI. Keep each build's symbols in its own directory.


suggestion: "Upload the matching .symbols files from your app's root directory" is ambiguous. It reads as if the .symbols files are in the app root, but they're actually in build/posthog-symbols/android and build/posthog-symbols/ios. The build commands above write them there, and the upload commands below point --directory at those folders. The phrase actually means "run these commands from the app root, because the paths are relative".

Say that directly:

Suggested change

Upload the matching \`.symbols\` files from your app's root directory. Sign in with \`posthog-cli login\`, or set \`POSTHOG_CLI_API_KEY\` and \`POSTHOG_CLI_PROJECT_ID\` in CI. Keep each build's symbols in its own directory.

Run these commands from your app's root directory to upload each build's \`.symbols\` files. Sign in with \`posthog-cli login\`, or set \`POSTHOG_CLI_API_KEY\` and \`POSTHOG_CLI_PROJECT_ID\` in CI. Keep each build's symbols in its own directory.

🤖 Clarified that the commands run from the app root to upload .symbols from the build directories in 85529e3.

…nboarding

deployment-status-posthog · 2026-10-28T16:26:59Z

Deploy status

Environment	Status	Deployed At	Workflow
dev	✅ Deployed	2026-10-28 16:26 UTC	Run
prod-us	✅ Deployed	2026-10-28 17:05 UTC	Run
prod-eu	✅ Deployed	2026-10-28 17:14 UTC	Run

chore(error-tracking): update Flutter symbol upload guide

49a46c1

hpouillot self-assigned this Oct 28, 2026

hpouillot requested review from a team, JamesPatrickGill and ablaszkiewicz October 28, 2026 13:39

hpouillot marked this pull request as ready for review October 28, 2026 13:39

hpouillot added 3 commits October 28, 2026 14:42

chore(error-tracking): specify Flutter SDK minimum version

029f856

chore: sync master for Flutter onboarding

c172cc3

chore(error-tracking): show minimum Flutter SDK in install step

6cf4506

hpouillot requested a review from a team October 28, 2026 14:11

hpouillot mentioned this pull request Oct 28, 2026

chore(error-tracking): guide Flutter Dart AOT symbol uploads PostHog/context-mill#445

Merged

JamesPatrickGill reviewed Oct 28, 2026

View reviewed changes

JamesPatrickGill approved these changes Oct 28, 2026

View reviewed changes

hpouillot added 2 commits October 28, 2026 16:19

chore(error-tracking): clarify Flutter onboarding instructions

85529e3

Merge remote-tracking branch 'origin/master' into chore/flutter-aot-o…

8aa3133

…nboarding

trunk-io Bot merged commit ba1e650 into master Oct 28, 2026
218 checks passed

trunk-io Bot deleted the chore/flutter-aot-onboarding branch October 28, 2026 16:03

hpouillot mentioned this pull request Nov 2, 2026

Sprint - November 2 to November 13 #124574

Open

Navigation Menu

Repository navigation

chore(error-tracking): document Flutter Dart symbol uploads - #124824

chore(error-tracking): document Flutter Dart symbol uploads#124824
trunk-io[bot] merged 6 commits into
masterfrom
chore/flutter-aot-onboarding

hpouillot commented Oct 28, 2026 •

edited

Loading

Uh oh!

trunk-io Bot commented Oct 28, 2026 •

edited

Loading

Uh oh!

github-actions Bot commented Oct 28, 2026 •

edited

Loading

Uh oh!

JamesPatrickGill Oct 28, 2026

Uh oh!

hpouillot Oct 28, 2026

Uh oh!

JamesPatrickGill Oct 28, 2026

Uh oh!

hpouillot Oct 28, 2026

Uh oh!

Uh oh!

deployment-status-posthog Bot commented Oct 28, 2026 •

edited

Loading

Uh oh!

Reviewers

Uh oh!

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

	Upload the matching \`.symbols\` files from your app's root directory. Sign in with \`posthog-cli login\`, or set \`POSTHOG_CLI_API_KEY\` and \`POSTHOG_CLI_PROJECT_ID\` in CI. Keep each build's symbols in its own directory.
	Run these commands from your app's root directory to upload each build's \`.symbols\` files. Sign in with \`posthog-cli login\`, or set \`POSTHOG_CLI_API_KEY\` and \`POSTHOG_CLI_PROJECT_ID\` in CI. Keep each build's symbols in its own directory.

Conversation

hpouillot commented Oct 28, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Problem

Changes

How did you test this code?

Release status

Docs update

🤖 Agent context

Uh oh!

trunk-io Bot commented Oct 28, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions Bot commented Oct 28, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🤖 CI report

Uh oh!

JamesPatrickGill Oct 28, 2026

Choose a reason for hiding this comment

Uh oh!

hpouillot Oct 28, 2026

Choose a reason for hiding this comment

Uh oh!

JamesPatrickGill Oct 28, 2026

Choose a reason for hiding this comment

Uh oh!

hpouillot Oct 28, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

deployment-status-posthog Bot commented Oct 28, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Deploy status

Uh oh!

Reviewers

Uh oh!

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

hpouillot commented Oct 28, 2026 •

edited

Loading

trunk-io Bot commented Oct 28, 2026 •

edited

Loading

github-actions Bot commented Oct 28, 2026 •

edited

Loading

deployment-status-posthog Bot commented Oct 28, 2026 •

edited

Loading