docs(flutter): update install docs and tutorials for posthog_flutter 6.0 by turnipdabeets · Pull Request #20924 · PostHog/posthog.com

turnipdabeets · 2026-10-07T20:42:40Z

Important

Hold until posthog_flutter 6.0 is released. Several pages describe 6.0 requirements (iOS 15, Xcode 26, PROJECT_TOKEN only), which are wrong for 5.x users until then.

Depends on:

chore!: Flutter Major Release v6 posthog-flutter#637, the 6.0 release. It also removes posthog_flutter.podspec, which the SPM-only text relies on.
posthog-ios 4.0 (chore!: iOS Major Release 4.0 posthog-ios#873) and posthog-android 4.0 (feat!: posthog-android 4.0 and posthog 7.0 posthog-android#871) released
[Waiting on mobile SDK releases] feat(docs): replace the mobile SDK pages with their Markdown references #22334 (stacked on [Waiting on SDK releases] feat(docs): replace the SDK pages with their Markdown references #22061) merged with or before this PR: it publishes /docs/libraries/flutter/migration from posthog-flutter's MIGRATION.md, which the CocoaPods notice links, and deletes /docs/libraries/flutter (flutter/index.mdx), which still shows enable()/disable(). The page content comes from docs: sort the Flutter 6.0.0 migration guide by when you make each change posthog-flutter#726.
docs(api): add capture v1 API reference #21385 merged with or before this PR: it adds /docs/api/capture-v1, which the migration guide links
Ships with docs(onboarding): update flutter install steps for posthog_flutter 6.0 posthog#128557 (Flutter onboarding)
Conflict to resolve: [Waiting on mobile SDK releases] feat(docs): replace the mobile SDK pages with their Markdown references #22334 edits surveys/_snippets/flutter-surveys-installation.mdx, which this PR deletes. Keep the deletion; nothing imports the file. (docs(android): posthog-android 4.0 upgrade guide and replay docs #21808 no longer conflicts.)

Changes

CocoaPods is removed in 6.0. Swift Package Manager becomes the only iOS and macOS option, with Flutter 3.41 or later. iOS add-to-app modules need Flutter 3.50 or later (flutter/flutter#184590 shipped in 3.50.0 stable), or stay on 5.x. The install snippets, surveys page and tutorials all say so.

Upgrade guide: the 5 → 6 upgrade guide lives at /docs/libraries/flutter/migration, generated from posthog-flutter's posthog_flutter/MIGRATION.md and published by #22334. This PR doesn't touch /docs/libraries/flutter (flutter/index.mdx), which #22334 deletes.

Docs for posthog_flutter 6.0.

Install snippets, the session replay snippet and the Flutter surveys page: the minimum is now iOS 15.0 instead of 13.0 (macOS 11.0 in the install snippets), with a note that building requires Xcode 26.
Flutter tutorials (analytics, A/B tests, feature flags, remote config):
- Flutter 3.41 or later on every platform, stated after the pubspec.yaml step; the iOS step says how to turn on SPM on Flutter 3.41 to 3.43.
- com.posthog.posthog.API_KEY → PROJECT_TOKEN. 6.0 no longer reads API_KEY, while PROJECT_TOKEN already works on 5.x.
- minSdkVersion 21 → 23. posthog-android already requires 23.
- iOS 13 → 15.
Feature flags snippet (feature-flags-code-flutter.mdx, shown on /docs/feature-flags/adding-feature-flag-code): uses Posthog().onFeatureFlags((loaded) { ... }) before setup(), with a note for 5.x readers to keep config.onFeatureFlags.
CocoaPods notice (flutter-cocoapods-notice.mdx): says 6.0 is SPM-only with no podspec, that apps that can't use SPM stay on 5.x, and links the migration guide.
Logs installation page: PostHogLogsConfig.beforeSend callbacks must be synchronous in 6.0 and later; 5.x also accepts asynchronous callbacks.
Removed surveys/_snippets/flutter-surveys-installation.mdx, which nothing imported.
Wizard eval (product-analytics/installation/flutter.eval.yaml): install-next (posthog_flutter 6 rubric) becomes install, replacing the 5.x rubric that fails once the snippets pin ^6.0.0.
Session replay snippet: drops the debouncerDelay comment; 6.0 removes that setter.
Cost-cutting page: the Flutter sample now uses sendFeatureFlagEvent instead of sendFeatureFlagEvents, which 6.0 removes.

Every claim was checked against the 6.0 branches and posthog-ios 4.0. Vale reports no alerts on the changed lines, apart from "Podfile" flagged as a misspelling on lines that already used the word.

Not in this PR:

The in-app onboarding steps in the posthog monorepo are in docs(onboarding): update flutter install steps for posthog_flutter 6.0 posthog#128557.
The upgrade guide itself, which is posthog_flutter/MIGRATION.md in posthog-flutter, published through [Waiting on mobile SDK releases] feat(docs): replace the mobile SDK pages with their Markdown references #22334.

Checklist

I've read the docs and/or content style guides.
Words are spelled using American English
Use relative URLs for internal links
I've checked the pages added or changed in the Vercel preview build
If I moved a page, I added a redirect in vercel.json

🤖 Generated with Claude Code

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>

github-actions · 2026-10-07T20:43:13Z

Deploy preview

Status	Details	Updated (UTC)
🟢 Ready	View preview	Nov 13, 2026 11:07PM

Changed pages

Page	Source
Cutting feature flag costs	`contents/docs/feature-flags/cutting-costs.mdx`
Flutter Logs installation	`contents/docs/logs/installation/flutter.mdx`
Flutter Surveys installation	`contents/docs/surveys/installation/flutter.mdx`
How to set up A/B tests in Flutter	`contents/tutorials/flutter-ab-tests.md`
How to set up analytics in Flutter	`contents/tutorials/flutter-analytics.md`
How to set up feature flags in Flutter	`contents/tutorials/flutter-feature-flags.md`
How to set up Flutter remote config	`contents/tutorials/flutter-remote-config.md`

github-actions · 2026-10-07T20:43:40Z

Vale prose linter → found 0 errors, 67 warnings, 0 suggestions in your markdown

Full report → Copy the linter results into an LLM to batch-fix issues.

Linter being weird? Update the rules!

contents/docs/_snippets/flutter-cocoapods-notice.mdx — 0 errors, 4 warnings, 0 suggestions

Line	Severity	Message	Rule
3:116	warning	'podspec' is a possible misspelling.	`PostHogBase.Spelling`
5:23	warning	Use 'X' instead of 'x'.	`Vale.Terms`
5:50	warning	Use 'X' instead of 'x'.	`Vale.Terms`
5:115	warning	Use 'X' instead of 'x'.	`Vale.Terms`

contents/docs/feature-flags/cutting-costs.mdx — 0 errors, 23 warnings, 0 suggestions

Line	Severity	Message	Rule
21:1	warning	Capitalize 'Feature Flags' for PostHog's product. Use 'Feature flags' for the general industry concept.	`PostHogBase.ProductNames`
21:102	warning	Capitalize 'Feature Flags' for PostHog's product. Use 'feature flags' for the general industry concept.	`PostHogBase.ProductNames`
23:30	warning	Capitalize 'Feature Flags' for PostHog's product. Use 'feature flags' for the general industry concept.	`PostHogBase.ProductNames`
26:63	warning	Capitalize 'Feature Flags' for PostHog's product. Use 'feature flags' for the general industry concept.	`PostHogBase.ProductNames`
37:1	warning	Capitalize 'Feature Flags' for PostHog's product. Use 'Feature flags' for the general industry concept.	`PostHogBase.ProductNames`
61:127	warning	Capitalize 'Feature Flags' for PostHog's product. Use 'feature flags' for the general industry concept.	`PostHogBase.ProductNames`
65:118	warning	Capitalize 'Feature Flags' for PostHog's product. Use 'feature flags' for the general industry concept.	`PostHogBase.ProductNames`
67:96	warning	Capitalize 'Feature Flags' for PostHog's product. Use 'feature flags' for the general industry concept.	`PostHogBase.ProductNames`
69:99	warning	Capitalize 'Feature Flags' for PostHog's product. Use 'feature flags' for the general industry concept.	`PostHogBase.ProductNames`
69:195	warning	Capitalize 'Surveys' for PostHog's product. Use 'surveys' for the general industry concept.	`PostHogBase.ProductNames`
69:240	warning	Capitalize 'Feature Flags' for PostHog's product. Use 'feature flags' for the general industry concept.	`PostHogBase.ProductNames`
69:275	warning	Capitalize 'Surveys' for PostHog's product. Use 'surveys' for the general industry concept.	`PostHogBase.ProductNames`
75:17	warning	Capitalize 'Feature Flags' for PostHog's product. Use 'feature flags' for the general industry concept.	`PostHogBase.ProductNames`
75:95	warning	Capitalize 'Surveys' for PostHog's product. Use 'surveys' for the general industry concept.	`PostHogBase.ProductNames`
75:115	warning	Capitalize 'Surveys' for PostHog's product. Use 'surveys' for the general industry concept.	`PostHogBase.ProductNames`
94:36	warning	'ETags' is a possible misspelling.	`PostHogBase.Spelling`
94:151	warning	Use 'PostHog' instead of 'posthog'.	`Vale.Terms`
106:107	warning	Capitalize 'Feature Flags' for PostHog's product. Use 'feature flags' for the general industry concept.	`PostHogBase.ProductNames`
258:214	warning	Capitalize 'Feature Flags' for PostHog's product. Use 'feature flags' for the general industry concept.	`PostHogBase.ProductNames`
258:229	warning	Capitalize 'Session Replay' for PostHog's product. Use 'session replay' for the general industry concept.	`PostHogBase.ProductNames`
258:249	warning	Capitalize 'Surveys' for PostHog's product. Use 'surveys' for the general industry concept.	`PostHogBase.ProductNames`
274:42	warning	Capitalize 'Feature Flags' for PostHog's product. Use 'feature flags' for the general industry concept.	`PostHogBase.ProductNames`
274:69	warning	Capitalize 'Surveys' for PostHog's product. Use 'surveys' for the general industry concept.	`PostHogBase.ProductNames`

contents/docs/integrate/_snippets/install-flutter.mdx — 0 errors, 1 warnings, 0 suggestions

Line	Severity	Message	Rule
132:6	warning	'Dart setup (For manual step only)' heading should be in sentence case, and product names should be capitalized.	`PostHogBase.SentenceCase`

contents/docs/integrate/feature-flags-code/_snippets/feature-flags-code-flutter.mdx — 0 errors, 7 warnings, 0 suggestions

Line	Severity	Message	Rule
1:13	warning	Capitalize 'Feature Flags' for PostHog's product. Use 'feature flags' for the general industry concept.	`PostHogBase.ProductNames`
13:18	warning	Capitalize 'Feature Flags' for PostHog's product. Use 'feature flags' for the general industry concept.	`PostHogBase.ProductNames`
27:83	warning	Capitalize 'Feature Flags' for PostHog's product. Use 'feature flags' for the general industry concept.	`PostHogBase.ProductNames`
29:39	warning	Capitalize 'Feature Flags' for PostHog's product. Use 'feature flags' for the general industry concept.	`PostHogBase.ProductNames`
49:91	warning	Use 'X' instead of 'x'.	`Vale.Terms`
51:15	warning	Capitalize 'Feature Flags' for PostHog's product. Use 'feature flags' for the general industry concept.	`PostHogBase.ProductNames`
53:91	warning	'refetch' is a possible misspelling.	`PostHogBase.Spelling`

contents/docs/logs/installation/flutter.mdx — 0 errors, 5 warnings, 0 suggestions

Line	Severity	Message	Rule
65:52	warning	Capitalize 'Logs' for PostHog's product. Use 'logs' for the general industry concept.	`PostHogBase.ProductNames`
98:86	warning	Capitalize 'Feature Flags' for PostHog's product. Use 'feature flags' for the general industry concept.	`PostHogBase.ProductNames`
141:30	warning	Use 'ID' instead of 'id'.	`Vale.Terms`
147:6	warning	Use 'X' instead of 'x'.	`Vale.Terms`
160:507	warning	Use 'X' instead of 'x'.	`Vale.Terms`

contents/docs/session-replay/_snippets/flutter-installation.mdx — 0 errors, 14 warnings, 0 suggestions

Line	Severity	Message	Rule
3:3	warning	Capitalize 'Session Replay' for PostHog's product. Use 'Session replay' for the general industry concept.	`PostHogBase.ProductNames`
10:20	warning	Capitalize 'Session Replay' for PostHog's product. Use 'session replay' for the general industry concept.	`PostHogBase.ProductNames`
16:48	warning	Capitalize 'Session Replay' for PostHog's product. Use 'session replay' for the general industry concept.	`PostHogBase.ProductNames`
45:36	warning	Use descriptive link text instead of '[this page]'.	`PostHogBase.DescriptiveLinkText`
73:19	warning	Capitalize 'Session Replay' for PostHog's product. Use 'session replay' for the general industry concept.	`PostHogBase.ProductNames`
92:14	warning	Capitalize 'Session Replay' for PostHog's product. Use 'session replay' for the general industry concept.	`PostHogBase.ProductNames`
96:4	warning	'Limitations for mobile session replay' heading should be in sentence case, and product names should be capitalized.	`PostHogBase.SentenceCase`
96:27	warning	Capitalize 'Session Replay' for PostHog's product. Use 'session replay' for the general industry concept.	`PostHogBase.ProductNames`
103:4	warning	'Limitations for Flutter Web session replay' heading should be in sentence case, and product names should be capitalized.	`PostHogBase.SentenceCase`
103:32	warning	Capitalize 'Session Replay' for PostHog's product. Use 'session replay' for the general industry concept.	`PostHogBase.ProductNames`
113:35	warning	Capitalize 'Session Replay' for PostHog's product. Use 'session replay' for the general industry concept.	`PostHogBase.ProductNames`
114:40	warning	Capitalize 'Session Replay' for PostHog's product. Use 'session replay' for the general industry concept.	`PostHogBase.ProductNames`
115:44	warning	Capitalize 'Feature Flags' for PostHog's product. Use 'feature flags' for the general industry concept.	`PostHogBase.ProductNames`
117:7	warning	Capitalize 'Session Replay' for PostHog's product. Use 'Session replay' for the general industry concept.	`PostHogBase.ProductNames`

contents/docs/surveys/installation/flutter.mdx — 0 errors, 2 warnings, 0 suggestions

Line	Severity	Message	Rule
13:64	warning	Capitalize 'Surveys' for PostHog's product. Use 'surveys' for the general industry concept.	`PostHogBase.ProductNames`
30:11	warning	Capitalize 'Surveys' for PostHog's product. Use 'surveys' for the general industry concept.	`PostHogBase.ProductNames`

contents/tutorials/flutter-ab-tests.md — 0 errors, 1 warnings, 0 suggestions

Line	Severity	Message	Rule
336:18	warning	Capitalize 'Feature Flags' for PostHog's product. Use 'feature flags' for the general industry concept.	`PostHogBase.ProductNames`

contents/tutorials/flutter-analytics.md — 0 errors, 5 warnings, 0 suggestions

Line	Severity	Message	Rule
19:2	warning	Capitalize 'Product Analytics' for PostHog's product. Use 'Product analytics' for the general industry concept.	`PostHogBase.ProductNames`
324:138	warning	Use 'PostHog' instead of 'Posthog'.	`Vale.Terms`
409:23	warning	Capitalize 'Logs' for PostHog's product. Use 'logs' for the general industry concept.	`PostHogBase.ProductNames`
450:18	warning	Capitalize 'Product Analytics' for PostHog's product. Use 'Product analytics' for the general industry concept.	`PostHogBase.ProductNames`
472:18	warning	Capitalize 'Feature Flags' for PostHog's product. Use 'feature flags' for the general industry concept.	`PostHogBase.ProductNames`

contents/tutorials/flutter-feature-flags.md — 0 errors, 3 warnings, 0 suggestions

Line	Severity	Message	Rule
2:22	warning	Capitalize 'Feature Flags' for PostHog's product. Use 'feature flags' for the general industry concept.	`PostHogBase.ProductNames`
16:2	warning	Capitalize 'Feature Flags' for PostHog's product. Use 'Feature flags' for the general industry concept.	`PostHogBase.ProductNames`
202:44	warning	Capitalize 'Feature Flags' for PostHog's product. Use 'feature flags' for the general industry concept.	`PostHogBase.ProductNames`

contents/tutorials/flutter-remote-config.md — 0 errors, 2 warnings, 0 suggestions

Line	Severity	Message	Rule
168:15	warning	Capitalize 'Feature Flags' for PostHog's product. Use 'feature flags' for the general industry concept.	`PostHogBase.ProductNames`
324:4	warning	Capitalize 'Feature Flags' for PostHog's product. Use 'Feature flags' for the general industry concept.	`PostHogBase.ProductNames`

github-actions · 2026-10-07T20:55:32Z

Bundle report

Total JS (gzip)

12.22 MiB (+0.4 KiB / +0.0%)

Eager graph (modules shipped in each entrypoint's initial chunks)

Entrypoint	Eager size	Budget	Modules
✅ `app`	11.15 MiB (-0.0 KiB / -0.0%)	report-only	1106

Largest modules in the app closure

Module	Size
`css ./node_modules/.pnpm/css-loader@5.2.7_webpack@5.101.3/node_modules/css-loader/dist/cjs.js??ruleSet[1].rules[8].oneOf[1].use[1]!./node_modules/.pnpm/postcss-loader@4.3.0_postcss@8.5.6_webpack@5.101.3/node_modules/postcss-loader/dist/cjs.js??ruleSet[1].rules[8].oneOf[1].use[2]!./src/styles/global.css`	1023.1 KiB
`./src/components/Stickers/Stickers.tsx`	696.4 KiB
`./node_modules/.pnpm/@posthog+brand@0.13.0_react@18.3.1/node_modules/@posthog/brand/dist/generated/hoggies/svg/puzzle.mjs`	388.5 KiB
`./node_modules/.pnpm/@posthog+icons@0.36.6_react-dom@18.3.1_react@18.3.1__react@18.3.1/node_modules/@posthog/icons/dist/posthog-icons.es.js`	354.8 KiB
`./node_modules/.pnpm/react-markdown@8.0.7_@types+react@16.14.66_react@18.3.1/node_modules/react-markdown/lib/react-markdown.js + 88 modules`	351.4 KiB
`./node_modules/.pnpm/@posthog+brand@0.13.0_react@18.3.1/node_modules/@posthog/brand/dist/generated/hoggies/svg/basketball-coach.mjs`	337.4 KiB
`./node_modules/.pnpm/framer-motion@14.0.0_react-dom@18.3.1_react@18.3.1__react@18.3.1/node_modules/framer-motion/dist/es/render/components/motion/proxy.mjs + 126 modules`	287.2 KiB
`./node_modules/.pnpm/cloudinary-core@2.14.0_lodash@4.17.21/node_modules/cloudinary-core/cloudinary-core.js`	281.9 KiB
`./src/components/SearchUI/index.tsx + 87 modules`	273.1 KiB
`./gatsby-browser.tsx + 60 modules`	259.4 KiB
`./node_modules/.pnpm/@posthog+brand@0.13.0_react@18.3.1/node_modules/@posthog/brand/dist/generated/hoggies/svg/construction-1.mjs`	248.5 KiB
`./src/components/Pricing/PricingSlider/Slider.tsx + 87 modules`	240.2 KiB
`./node_modules/.pnpm/@posthog+brand@0.13.0_react@18.3.1/node_modules/@posthog/brand/dist/generated/hoggies/svg/construction-2.mjs`	228.2 KiB
`./node_modules/.pnpm/@posthog+brand@0.13.0_react@18.3.1/node_modules/@posthog/brand/dist/generated/hoggies/svg/magnifying-glass.mjs`	221.7 KiB
`./src/hooks/useProduct.ts + 18 modules`	166.5 KiB

Eager-graph budgets are report-only until a baseline is established. Sizes are gzip of public/**/*.js; eager size is webpack module source bytes for the modules actually shipped in the entrypoint's initial chunks (post-tree-shake).

github-actions · 2026-10-22T07:44:43Z

This PR hasn't seen activity in two weeks! Should it be merged, closed, or further worked on? If you want to keep it open, please remove the stale label – otherwise this will be closed in another week. If you want to permanently keep it open, use the waiting label.

eli-r-ph · 2026-10-26T22:22:47Z

Flutter 6 sends events from iOS, macOS, Android, Windows and Linux to capture v1. Could the upgrade guide say so in one section, list what a reverse proxy must forward (/i/v1/analytics/events, /i/v1/ai/events and the Authorization header), and link the posthog-ios and posthog-android 4.0 migration guides?

eli-r-ph · 2026-10-27T02:05:26Z

One addition for the proxy section: the proxy also needs to pass every PostHog-* header through and accept request bodies up to 20 MB (nginx and ingress-nginx default to 1 MB). The server SDK guides use this checklist: https://github.com/PostHog/posthog-python/blob/235047e220c48e1a69ab7354564ceefe035c4b34/docs/migration-7.x-to-8.0.md#L44-L50

… 6 guide

turnipdabeets · 2026-10-28T23:22:37Z

@eli-r-ph I added the capture v1 parts to the Flutter 6 upgrade guide (3284e0f): endpoints per platform (web stays on posthog-js), reverse proxy and self-hosted requirements, property precedence, per-event options, captureAi, and the 404/429 retry behavior. Can you check that it matches the v1 rules for the other SDKs?

posthog

PostHog Review · Standard · reviewed 3284e0f: 5 Should fix.

This is the only automatic review while this pull request is a draft. Comment @posthog review to review new changes sooner. Otherwise, a review of the new changes runs when you mark it ready for review.

See this review and its findings in PostHog Review. Comment @posthog review --deep for a Deep review. A Deep review takes longer and looks deeper than a Standard review.

…, native addBeforeSend, phx_ keys everywhere

eli-r-ph · 2026-10-30T15:59:12Z

@turnipdabeets thanks, the capture v1 parts read well. A few additions for the 6.0 guide:

onFeatureFlags now takes a PostHogFeatureFlagsLoaded, and reloadFeatureFlags() returns Future<PostHogFeatureFlagsLoaded>, so 5.x callbacks written as () {} break.
AI queue defaults (100 events, 50 MiB on desktop, 60 s timeout, 8 MiB + 64 KiB event cap), and that flush() and close() also send the AI queue.
NaN and infinite property values are dropped rather than sent as null, and empty event names are dropped on the device.
What changed from 5.x on Windows and Linux: backoff with jitter instead of a fixed 3 s wait, a timeout after 10 s without progress, redirects drop the batch, Retry-After is capped at 30 s, and batches are capped at 5 MiB.
Failure reporting and logs: the loss summary is debug-only, the one-time 404 warning prints without debug, and the old log text is gone.
Synchronous beforeSend (Fix Superlist of Minor Issues #686), including that on iOS, macOS and Android a capture() followed straight away by optOut(), close() or setup() drops that event.
The proxy rule from the updated proxy guides: a proxy that strips other credentials should keep Authorization values that start with Bearer phc_, or the exact Bearer <token> if the project token doesn't start with phc_. The "managed reverse proxy" link also points to the proxy index rather than the managed proxy page.

Add Event options and Capturing AI events sections to the Flutter page, with the captureAi queue settings and their defaults. The version 6 upgrade guide now covers what changed and links to them. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

Add onFeatureFlags, synchronous beforeSend, the Windows and Linux changes from 5.x and the proxy Authorization rule. Link the managed proxy page, list Windows and Linux as supported, and mark AI observability as supported. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

turnipdabeets · 2026-10-30T16:34:49Z

@eli-r-ph thanks, these are in now (00c3ba4, plus 0294168 for the AI queue defaults):

onFeatureFlags and reloadFeatureFlags(): added, with a before/after example.
AI queue defaults and flush()/close(): in the new "Capturing AI events" section. The 50 MiB cap applies on every platform, not just desktop, so the guide doesn't scope it to desktop.
NaN, infinite values and empty names: under Windows and Linux, since that's the Dart code I checked. In a list, a non-finite value becomes null so the other elements keep their positions.
Windows and Linux changes from 5.x: added as their own section.
Logs: the count of dropped events is debug-only and the 404 warning prints without debug. I left out "the old log text is gone", because most of the old messages, such as Error while flushing PostHog, are still in Custom icon for changelog / update notes in the new top navigation. #673. Tell me if you meant specific ones.
Synchronous beforeSend: added. The dropped event after optOut(), close() or setup() is described as happening only when beforeSend is set, because without callbacks Fixed link to "Spending money" section of the handbook. #682 still makes a single native call. Fix Superlist of Minor Issues #686's changeset still says the opposite, and your threads on Fixed link to "Spending money" section of the handbook. #682 and Fix Superlist of Minor Issues #686 are still open.
Proxy: added the Bearer phc_ rule, and the managed proxy link now goes to the managed proxy page.

The guide's beforeSend text depends on #682 and #686, so both are now listed as dependencies in the description.

posthog-flutter keeps the call queue on iOS, macOS and Android, so the event isn't dropped. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

turnipdabeets · 2026-10-30T16:45:19Z

@eli-r-ph a correction to my last comment: the event is no longer dropped after optOut(), close() or setup(). iOS, macOS and Android keep CallOrder (posthog-flutter 41ea6b0), so those calls wait until the event is sent, and the guide no longer describes a drop (130b83d).

gewenyu99

will stamp and re-review once release is out. Comment from bot

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

…upgrade checklist in the v6 guide Add registerOptions()/unregisterOptions() to event options, super properties and the platform interface list, the $lib pair exception, the missing-flag $feature_flag_response and null changes on iOS, macOS and Android, the posthog-server binary compatibility note, debug log text, close() timing on Windows and Linux, and an upgrade checklist. Point the Android guide link at MIGRATION.md. Claude-Session: https://claude.ai/code/session_019xLynttdFZAHfqTem5BhPQ

Claude-Session: https://claude.ai/code/session_019xLynttdFZAHfqTem5BhPQ

eli-r-ph · 2026-11-10T19:42:59Z

The description's 'Not in this PR' list is out of date. The PR now edits the session replay snippet and deletes the surveys snippet, in-app onboarding moved to PostHog/posthog#128557, and the AI events section comes from #21963.

…klist

…entify events Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

…ess setting Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

turnipdabeets · 2026-11-11T00:32:40Z

@eli-r-ph Updated the description: it now lists the session replay snippet, the deleted surveys snippet, PostHog/posthog#128557 and #21963.

Web beforeSend now sees $current_url, $host and $pathname (posthog-flutter#714). Add the rolling-back-to-5.x notes from MIGRATION.md, and macOS 11.0 to the install snippets. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

…personless Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

eli-r-ph · 2026-11-12T18:26:04Z

#22061 lands before this PR. It deletes contents/docs/libraries/flutter/index.mdx, which this PR edits, and redirects it to /docs/libraries/flutter/reference. That page shows posthog-flutter docs/getting-started.md (PostHog/posthog-flutter#726) as its "Getting started" section, so the new sections here need a home there or in MIGRATION.md. These links also need new targets:

contents/docs/_snippets/flutter-cocoapods-notice.mdx:3: /docs/libraries/flutter#upgrading-from-version-5-to-version-6 → /docs/libraries/flutter/migration
contents/docs/libraries/flutter/index.mdx:632: /docs/libraries/capture-v1 (removed in docs(api): add capture v1 API reference #21385, redirects to the SDK overview) → /docs/api/capture-v1
contents/docs/libraries/flutter/index.mdx:710: #ai-events has no matching heading on the page → the "Events go to capture v1" section of /docs/libraries/flutter/migration

The upgrade guide now lives at /docs/libraries/flutter/migration (#21385), so restore flutter/index.mdx to master, point the CocoaPods notice at the migration guide, and scope the synchronous logs beforeSend rule to 6.0. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

…ery platform Flutter 3.50.0 stable ships flutter/flutter#184590, so iOS add-to-app modules install plugins through SPM there. The tutorials now say the Flutter 3.41 floor applies on every platform, not just iOS. Drops the debouncerDelay note (6.0 removes it) and a doubled "in Xcode". Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

…ration

Once these docs pin ^6.0.0, the 5.x `install` rubric fails by design. Promote `install-next` to `install` and drop the 5.x one. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

docs(flutter): add the version 6 upgrade guide and update pages for 6.0

6df2d53

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>

turnipdabeets mentioned this pull request Oct 7, 2026

chore!: Flutter Major Release v6 PostHog/posthog-flutter#637

Draft

6 of 17 tasks

github-actions Bot added docs Improvements or additions to product documentation, "Docs" content PR only touches files under contents/ labels Oct 7, 2026

turnipdabeets mentioned this pull request Oct 7, 2026

chore!: iOS Major Release 4.0 PostHog/posthog-ios#873

Draft

6 of 18 tasks

github-actions Bot added the stale This pull request has been marked as stale and will be closed soon automatically label Oct 22, 2026

turnipdabeets removed the stale This pull request has been marked as stale and will be closed soon automatically label Oct 22, 2026

turnipdabeets mentioned this pull request Oct 26, 2026

feat!: capture v1 on every platform, with per-event options and captureAi PostHog/posthog-flutter#673

Merged

6 of 8 tasks

docs(flutter): cover capture v1, options and captureAi in the version…

3284e0f

… 6 guide

turnipdabeets requested a review from eli-r-ph October 28, 2026 23:22

posthog Bot reviewed Oct 28, 2026

View reviewed changes

turnipdabeets added 2 commits October 28, 2026 20:50

docs(flutter): pin tutorials to posthog_flutter 6 for PROJECT_TOKEN keys

6a93390

docs(flutter): beforeSend gets the final event on every platform in 6…

b946703

…, native addBeforeSend, phx_ keys everywhere

turnipdabeets mentioned this pull request Oct 29, 2026

feat!: make beforeSend callbacks synchronous PostHog/posthog-flutter#686

Merged

5 of 6 tasks

turnipdabeets and others added 2 commits October 30, 2026 12:05

docs(flutter): optOut after capture no longer applies to the event first

130b83d

posthog-flutter keeps the call queue on iOS, macOS and Android, so the event isn't dropped. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

eli-r-ph reviewed Oct 30, 2026

View reviewed changes

Comment thread contents/docs/libraries/flutter/index.mdx Resolved

Comment thread contents/docs/libraries/flutter/index.mdx Resolved

docs(flutter): align the version 6 upgrade guide with the migration file

b93249c

turnipdabeets mentioned this pull request Oct 31, 2026

docs(android): posthog-android 4.0 upgrade guide and replay docs #21808

Draft

5 of 12 tasks

gewenyu99 reviewed Nov 9, 2026

View reviewed changes

Comment thread contents/docs/libraries/flutter/index.mdx Resolved

turnipdabeets and others added 4 commits November 9, 2026 18:38

docs(logs): Flutter log beforeSend callbacks are synchronous in v6

5548a78

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

docs: fix Vale errors (en dashes, straight quotes)

d74e374

Claude-Session: https://claude.ai/code/session_019xLynttdFZAHfqTem5BhPQ

Merge branch 'master' into docs/flutter-v6-migration

0324422

eli-r-ph reviewed Nov 10, 2026

View reviewed changes

Comment thread contents/docs/libraries/flutter/index.mdx Resolved

eli-r-ph reviewed Nov 10, 2026

View reviewed changes

Comment thread contents/docs/libraries/flutter/index.mdx Resolved

eli-r-ph reviewed Nov 10, 2026

View reviewed changes

Comment thread contents/docs/libraries/flutter/index.mdx Resolved

eli-r-ph reviewed Nov 10, 2026

View reviewed changes

Comment thread contents/docs/libraries/flutter/index.mdx Resolved

turnipdabeets added 4 commits November 10, 2026 14:46

docs(flutter): drop Windows and Linux bullets that 5.x already had

6934d29

docs(flutter): use the shared legacy option sentence once

95128f7

docs(flutter): rename the upgrade AI events heading to captureAi

8881fa5

docs(flutter): add flag variant and payload steps to the upgrade chec…

ee5930f

…klist

eli-r-ph reviewed Nov 10, 2026

View reviewed changes

Comment thread contents/docs/libraries/flutter/index.mdx Resolved

eli-r-ph reviewed Nov 10, 2026

View reviewed changes

Comment thread contents/docs/libraries/flutter/index.mdx Resolved

turnipdabeets and others added 2 commits November 10, 2026 15:29

docs(flutter): note that a registered process_person_profile drops id…

ce4c891

…entify events Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

docs(flutter): replace en dashes and dash table cells

bb13173

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

eli-r-ph reviewed Nov 10, 2026

View reviewed changes

Comment thread contents/docs/libraries/flutter/index.mdx Resolved

eli-r-ph reviewed Nov 10, 2026

View reviewed changes

Comment thread contents/docs/libraries/flutter/index.mdx Resolved

docs(flutter): show how to keep identifying with a registered personl…

1ac2891

…ess setting Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

turnipdabeets and others added 2 commits November 12, 2026 11:03

docs(flutter): Android rollback too; identity calls under registered …

25a4aa8

…personless Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

turnipdabeets and others added 4 commits November 12, 2026 15:14

Merge remote-tracking branch 'origin/master' into docs/flutter-v6-mig…

6a7d1e6

…ration

docs(evals): grade the Flutter install check against posthog_flutter 6

8a55110

Once these docs pin ^6.0.0, the 5.x `install` rubric fails by design. Promote `install-next` to `install` and drop the 5.x one. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

turnipdabeets changed the title ~~docs(flutter): version 6 upgrade guide~~ docs(flutter): update install docs and tutorials for posthog_flutter 6.0 Nov 13, 2026

Conversation

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

Uh oh!

Changes

Checklist

Uh oh!

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

Uh oh!

Deploy preview

Changed pages

Uh oh!

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

Uh oh!

Uh oh!

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

Uh oh!

Bundle report

Total JS (gzip)

Eager graph (modules shipped in each entrypoint's initial chunks)

Uh oh!

github-actions Bot commented Oct 22, 2026

Uh oh!

eli-r-ph commented Oct 26, 2026

Uh oh!

eli-r-ph commented Oct 27, 2026

Uh oh!

turnipdabeets commented Oct 28, 2026

Uh oh!

posthog Bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

eli-r-ph commented Oct 30, 2026

Uh oh!

turnipdabeets commented Oct 30, 2026

Uh oh!

turnipdabeets commented Oct 30, 2026

Uh oh!

Uh oh!

Uh oh!

gewenyu99 left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

eli-r-ph commented Nov 10, 2026

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

turnipdabeets commented Nov 11, 2026

Uh oh!

eli-r-ph commented Nov 12, 2026

Uh oh!

This branch has not been deployed

Reviewers

Uh oh!

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

turnipdabeets commented Oct 7, 2026 •

edited

Loading

github-actions Bot commented Oct 7, 2026 •

edited

Loading

github-actions Bot commented Oct 7, 2026 •

edited

Loading

github-actions Bot commented Oct 7, 2026 •

edited

Loading