Skip to content

docs(replay): screenshot-only mobile replay for Android and iOS 4.0 - #21741

Draft
turnipdabeets wants to merge 1 commit into
docs/kmp-verify-screenshot-mask-alignmentfrom
docs/mobile-replay-drop-wireframe
Draft

turnipdabeets wants to merge 1 commit into
docs/kmp-verify-screenshot-mask-alignmentfrom
docs/mobile-replay-drop-wireframe

Conversation

@turnipdabeets

@turnipdabeets turnipdabeets commented Oct 29, 2026 •

Copy link
Copy Markdown
Contributor

Important

Draft until posthog-android 4.0 and posthog-ios 4.0 ship. Stacked on #21651, which merges first. GitHub retargets this to master when that branch is deleted. Companion monorepo PR for the generated install steps: PostHog/posthog#125537.

Changes

posthog-android 4.0 (PostHog/posthog-android#908) and posthog-ios 4.0 (PostHog/posthog-ios#907, PostHog/posthog-ios#973) remove wireframe session replay. Replay always records masked screenshots, and screenshot / screenshotMode are gone. posthog-kmp removes SessionRecordingConfig.screenshot (PostHog/posthog-kmp#109).

  • session-replay/mobile.mdx: screenshot mode is now the main section. It says all SDKs record screenshots (Android and iOS from 4.0) and that screenshots show anything that isn't masked, such as custom-drawn views, maps and video. Wireframe mode moves to a "before 4.0" section that keeps the screenshot / screenshotMode instructions for 3.x users.
  • session-replay/start-here.mdx, session-replay/installation/index.mdx: drop "wireframe-only mode unless screenshot mode is enabled" from the mobile limitations.
  • libraries/kmp/index.mdx: replace the screenshot-mode example and the screenshot table row with a note on masking and on the option's removal. On top of docs(kmp): explain Android screenshot mask alignment verification #21651, drop screenshot = true from its verifyScreenshotMaskAlignment example and say "Android" rather than "Android screenshot mode".

Before merging:

Not changed here:

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 (no pages moved)

Vale shows no new warnings on the changed lines. Not rendered locally.

🤖 Agent context

Autonomy: Human-driven (agent-assisted)

Written with Claude Code (Opus 5.5) at the maintainer's request, alongside the Android, KMP and React Native wireframe-removal PRs.

🤖 Generated with Claude Code

@github-actions

github-actions Bot commented Oct 29, 2026 •

Copy link
Copy Markdown
Contributor

Deploy preview

Status Details Updated (UTC)
🟢 Ready View preview Oct 29, 2026 03:05PM

Changed pages

Page Source
Kotlin Multiplatform contents/docs/libraries/kmp/index.mdx
Session Replay installation contents/docs/session-replay/installation/index.mdx
Mobile session replay contents/docs/session-replay/mobile.mdx
Get started with Session Replay contents/docs/session-replay/start-here.mdx

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

github-actions Bot commented Oct 29, 2026 •

Copy link
Copy Markdown
Contributor

Vale prose linter → found 0 errors, 63 warnings, 6 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/libraries/kmp/index.mdx — 0 errors, 50 warnings, 6 suggestions
Line Severity Message Rule
6:18 warning Use 'GitHub' instead of 'github'. Vale.Terms
6:37 warning Use 'PostHog' instead of 'posthog'. Vale.Terms
21:35 warning Use 'kmp' instead of 'KMP'. Vale.Terms
21:436 warning Capitalize 'Session Replay' for PostHog's product. Use 'session replay' for the general industry concept. PostHogBase.ProductNames
104:98 warning Capitalize 'Feature Flags' for PostHog's product. Use 'feature flags' for the general industry concept. PostHogBase.ProductNames
162:6 warning 'JVM (desktop)' heading should be in sentence case, and product names should be capitalized. PostHogBase.SentenceCase
177:7 warning 'Configure Compose Desktop release builds' heading should be in sentence case, and product names should be capitalized. PostHogBase.SentenceCase
221:177 warning 'Gson' is a possible misspelling. PostHogBase.Spelling
221:217 warning 'deserializes' is a possible misspelling. PostHogBase.Spelling
221:327 warning 'Gson' is a possible misspelling. PostHogBase.Spelling
221:356 warning 'Okio' is a possible misspelling. PostHogBase.Spelling
223:170 warning Use 'kmp' instead of 'KMP'. Vale.Terms
225:205 warning Capitalize 'Logs' for PostHog's product. Use 'logs' for the general industry concept. PostHogBase.ProductNames
264:38 warning Use 'kmp' instead of 'KMP'. Vale.Terms
314:93 suggestion Address the reader directly. Use 'you' instead of 'the user'. PostHogDocs.DirectAddress
369:44 suggestion Address the reader directly. Use 'you' instead of 'the user'. PostHogDocs.DirectAddress
371:44 suggestion Address the reader directly. Use 'you' instead of 'the user'. PostHogDocs.DirectAddress
371:75 suggestion Address the reader directly. Use 'you' instead of 'the user'. PostHogDocs.DirectAddress
381:4 warning Capitalize 'Feature Flags' for PostHog's product. Use 'Feature flags' for the general industry concept. PostHogBase.ProductNames
381:4 warning 'Feature flags' heading should be in sentence case, and product names should be capitalized. PostHogBase.SentenceCase
387:23 warning 'preloaded' is a possible misspelling. PostHogBase.Spelling
425:1 warning Capitalize 'Feature Flags' for PostHog's product. Use 'Feature flags' for the general industry concept. PostHogBase.ProductNames
435:8 warning Capitalize 'Experiments' for PostHog's product. Use 'experiments' for the general industry concept. PostHogBase.ProductNames
435:55 warning Capitalize 'Feature Flags' for PostHog's product. Use 'feature flags' for the general industry concept. PostHogBase.ProductNames
443:28 warning Capitalize 'Experiments' for PostHog's product. Use 'experiments' for the general industry concept. PostHogBase.ProductNames
443:54 warning Capitalize 'Feature Flags' for PostHog's product. Use 'feature flags' for the general industry concept. PostHogBase.ProductNames
495:4 warning Capitalize 'Error Tracking' for PostHog's product. Use 'Error tracking' for the general industry concept. PostHogBase.ProductNames
495:4 warning 'Error tracking' heading should be in sentence case, and product names should be capitalized. PostHogBase.SentenceCase
530:4 warning Capitalize 'Session Replay' for PostHog's product. Use 'Session replay' for the general industry concept. PostHogBase.ProductNames
530:4 warning 'Session replay' heading should be in sentence case, and product names should be capitalized. PostHogBase.SentenceCase
532:2 warning Capitalize 'Session Replay' for PostHog's product. Use 'Session replay' for the general industry concept. PostHogBase.ProductNames
623:10 suggestion Address the reader directly. Use 'you' instead of 'the user'. PostHogDocs.DirectAddress
623:90 suggestion Address the reader directly. Use 'you' instead of 'the user'. PostHogDocs.DirectAddress
623:99 warning Capitalize 'Logs' for PostHog's product. Use 'logs' for the general industry concept. PostHogBase.ProductNames
639:34 warning Capitalize 'Feature Flags' for PostHog's product. Use 'feature flags' for the general industry concept. PostHogBase.ProductNames
639:52 warning Capitalize 'Session Replay' for PostHog's product. Use 'session replay' for the general industry concept. PostHogBase.ProductNames
639:121 warning Capitalize 'Logs' for PostHog's product. Use 'logs' for the general industry concept. PostHogBase.ProductNames
664:56 warning Capitalize 'Feature Flags' for PostHog's product. Use 'feature flags' for the general industry concept. PostHogBase.ProductNames
671:84 warning Capitalize 'Session Replay' for PostHog's product. Use 'session replay' for the general industry concept. PostHogBase.ProductNames
698:69 warning Capitalize 'Logs' for PostHog's product. Use 'logs' for the general industry concept. PostHogBase.ProductNames
699:59 warning 'logcat' is a possible misspelling. PostHogBase.Spelling
700:54 warning 'debounce' is a possible misspelling. PostHogBase.Spelling
712:128 warning Capitalize 'Session Replay' for PostHog's product. Use 'Session replay' for the general industry concept. PostHogBase.ProductNames
714:44 warning Capitalize 'Feature Flags' for PostHog's product. Use 'feature flags' for the general industry concept. PostHogBase.ProductNames
714:67 warning Capitalize 'Error Tracking' for PostHog's product. Use 'error tracking' for the general industry concept. PostHogBase.ProductNames
714:437 warning Capitalize 'Feature Flags' for PostHog's product. Use 'feature flags' for the general industry concept. PostHogBase.ProductNames
716:4 warning 'FAQ' heading should be in sentence case, and product names should be capitalized. PostHogBase.SentenceCase
718:30 warning Use 'kmp' instead of 'KMP'. Vale.Terms
724:81 warning Use 'kmp' instead of 'KMP'. Vale.Terms
726:21 warning Capitalize 'Surveys' for PostHog's product. Use 'surveys' for the general industry concept. PostHogBase.ProductNames
726:32 warning Capitalize 'Logs' for PostHog's product. Use 'logs' for the general industry concept. PostHogBase.ProductNames
728:5 warning Use 'kmp' instead of 'KMP'. Vale.Terms
728:66 warning Capitalize 'Feature Flags' for PostHog's product. Use 'feature flags' for the general industry concept. PostHogBase.ProductNames
728:115 warning Capitalize 'Session Replay' for PostHog's product. Use 'session replay' for the general industry concept. PostHogBase.ProductNames
728:135 warning Capitalize 'Error Tracking' for PostHog's product. Use 'error tracking' for the general industry concept. PostHogBase.ProductNames
728:163 warning Capitalize 'Logs' for PostHog's product. Use 'logs' for the general industry concept. PostHogBase.ProductNames
contents/docs/session-replay/installation/index.mdx — 0 errors, 1 warnings, 0 suggestions
Line Severity Message Rule
12:1 warning Capitalize 'Session Replay' for PostHog's product. Use 'Session replay' for the general industry concept. PostHogBase.ProductNames
contents/docs/session-replay/mobile.mdx — 0 errors, 7 warnings, 0 suggestions
Line Severity Message Rule
2:15 warning Capitalize 'Session Replay' for PostHog's product. Use 'session replay' for the general industry concept. PostHogBase.ProductNames
5:20 warning Capitalize 'Session Replay' for PostHog's product. Use 'session replay' for the general industry concept. PostHogBase.ProductNames
7:8 warning Capitalize 'Session Replay' for PostHog's product. Use 'session replay' for the general industry concept. PostHogBase.ProductNames
7:126 warning Capitalize 'Logs' for PostHog's product. Use 'logs' for the general industry concept. PostHogBase.ProductNames
37:12 warning Capitalize 'Session Replay' for PostHog's product. Use 'session replay' for the general industry concept. PostHogBase.ProductNames
38:8 warning Capitalize 'Session Replay' for PostHog's product. Use 'session replay' for the general industry concept. PostHogBase.ProductNames
40:12 warning Capitalize 'Session Replay' for PostHog's product. Use 'session replay' for the general industry concept. PostHogBase.ProductNames
contents/docs/session-replay/start-here.mdx — 0 errors, 5 warnings, 0 suggestions
Line Severity Message Rule
20:83 warning Capitalize 'Session Replay' for PostHog's product. Use 'session replay' for the general industry concept. PostHogBase.ProductNames
46:147 warning Capitalize 'Logs' for PostHog's product. Use 'logs' for the general industry concept. PostHogBase.ProductNames
74:1 warning Capitalize 'Session Replay' for PostHog's product. Use 'Session replay' for the general industry concept. PostHogBase.ProductNames
98:100 warning Capitalize 'Session Replay' for PostHog's product. Use 'Session replay' for the general industry concept. PostHogBase.ProductNames
114:1 warning Capitalize 'Session Replay' for PostHog's product. Use 'Session replay' for the general industry concept. PostHogBase.ProductNames

…iOS 4.0

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@turnipdabeets
turnipdabeets force-pushed the docs/mobile-replay-drop-wireframe branch from fb6a943 to e6e810a Compare October 29, 2026 14:46
@turnipdabeets
turnipdabeets changed the base branch from master to docs/kmp-verify-screenshot-mask-alignment October 29, 2026 14:46
@github-actions

Copy link
Copy Markdown
Contributor

Bundle report

Total JS (gzip)

10.44 MiB (-77.7 KiB / -0.7%)

Largest changed named chunks
Chunk Gzip Δ vs master
fe8bb93dcba62e8ce8a062d724dbc8a69309bd57.js 81.9 KiB new
f54b42984bfe4d114461fcea2710af414ac1fe74.js 21.6 KiB new
035c3a5dbce655498ebf426080fef9033b4583db.js 4.8 KiB new
component---src-pages-group-analytics-pricing-tsx.js 0.3 KiB new
component---src-pages-group-analytics-index-tsx.js 0.2 KiB new

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

Entrypoint Eager size Budget Modules
✅ app 20.36 MiB (-29.7 KiB / -0.1%) report-only 2110
Largest modules in the app closure
Module Size
./src/data/mcp-tools.json 1458.7 KiB
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 816.8 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/x-ray.mjs 481.2 KiB
./node_modules/.pnpm/@posthog+brand@0.13.0_react@18.3.1/node_modules/@posthog/brand/dist/generated/hoggies/svg/trenchcoat.mjs 450.8 KiB
./node_modules/.pnpm/rehype-raw@7.0.0/node_modules/rehype-raw/lib/index.js + 29 modules 395.1 KiB
./node_modules/.pnpm/@posthog+brand@0.13.0_react@18.3.1/node_modules/@posthog/brand/dist/generated/hoggies/svg/im-the-driver.mjs 385.8 KiB
./src/hooks/useCustomers.tsx + 61 modules 381.8 KiB
./node_modules/.pnpm/@posthog+brand@0.13.0_react@18.3.1/node_modules/@posthog/brand/dist/generated/hoggies/svg/tourist.mjs 364.6 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
./src/components/ProductComparisonTable/index.tsx + 130 modules 314.2 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 + 127 modules 287.8 KiB
./node_modules/.pnpm/@posthog+brand@0.13.0_react@18.3.1/node_modules/@posthog/brand/dist/generated/hoggies/svg/doll-house.mjs 284.1 KiB
./node_modules/.pnpm/cloudinary-core@2.14.0_lodash@4.17.21/node_modules/cloudinary-core/cloudinary-core.js 281.9 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).

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

content PR only touches files under contents/ docs Improvements or additions to product documentation, "Docs"

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant