Skip to content

fix(home): defer EU-cloud flag read to avoid React #418 hydration mismatch - #17764

Closed
posthog[bot] wants to merge 1 commit into
masterfrom
posthog-code/fix-homepage-hydration-418
Closed

posthog[bot] wants to merge 1 commit into
masterfrom
posthog-code/fix-homepage-hydration-418

Conversation

@posthog

@posthog posthog Bot commented Jun 18, 2026

Copy link
Copy Markdown
Contributor

Changes

The homepage (src/components/Home/Test/index.tsx) is the source of the single highest-volume error on posthog.com — a React #418 hydration mismatch firing on initial load.

The MDXEditor cta href computed its host by calling posthog?.isFeatureEnabled?.('direct-to-eu-cloud') directly during render. Since the site is server-rendered by Gatsby, SSR produces the app host while client hydration produces eu for EU users with the flag enabled — a server/client markup mismatch.

This defers the flag read into state via posthog.onFeatureFlags(...) inside a useEffect. SSR and the first client render both emit app; we only switch to eu once flags are available on the client. This mirrors the RenderInClient pattern the sibling Hero component already uses.

Audited the rest of the homepage render path: the only other in-render flag read (Hero, line 444) is already wrapped in RenderInClient, and both Math.random() calls run in event/animation handlers, not during render.

Why: #418 fired ~4.97M times across ~413K sessions and ~246K users in 30 days on the primary marketing entry point, causing UI flicker, dropped event listeners, and load-time perf degradation.

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

Created with PostHog Code from an inbox report.

…match

The homepage MDXEditor `cta` href read `posthog.isFeatureEnabled('direct-to-eu-cloud')` directly during render. SSR produces the 'app' host while client hydration produces 'eu' for EU users with the flag, causing a server/client markup mismatch (the highest-volume error on posthog.com).

Resolve the flag in state via `onFeatureFlags` in a useEffect so SSR and the first client render both emit 'app', switching to 'eu' only after flags load on the client — matching the RenderInClient pattern the sibling Hero already uses.

Generated-By: PostHog Code
Task-Id: 0f5d92f7-8f21-44fe-8f3a-bdb49aa2b017
@github-actions

github-actions Bot commented Jun 18, 2026 •

Copy link
Copy Markdown
Contributor

Deploy preview

Status Details Updated (UTC)
🟢 Ready View preview Jun 18, 2026 02:34PM

@github-actions

Copy link
Copy Markdown
Contributor

Bundle report

Total JS (gzip)

6.21 MiB (+0.0 KiB / +0.0%)

Eager graph (static-import closure per entrypoint)

Entrypoint Eager size Budget Modules
✅ app 24.08 MiB (no change) report-only 5497
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 709.9 KiB
./src/components/Stickers/Stickers.tsx 696.4 KiB
./.cache/caches/gatsby-plugin-mdx/mdx-scopes-dir/31a094f140f119e73085d847ae81b99b.js + 2 modules 507.3 KiB
./node_modules/.pnpm/@radix-ui+react-icons@1.3.2_react@18.3.1/node_modules/@radix-ui/react-icons/dist/react-icons.esm.js 481.4 KiB
./node_modules/.pnpm/@codemirror+view@6.38.2/node_modules/@codemirror/view/dist/index.js 458.1 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+icons@0.36.6_react-dom@18.3.1_react@18.3.1__react@18.3.1/node_modules/@posthog/icons/dist/posthog-icons.cjs.js 364.8 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
./src/hooks/useCustomers.tsx + 54 modules 353.9 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/cloudinary-core@2.14.0_lodash@4.17.21/node_modules/cloudinary-core/cloudinary-core.js 281.9 KiB
./node_modules/.pnpm/@codesandbox+sandpack-react@2.20.0_react-dom@18.3.1_react@18.3.1__react@18.3.1/node_modules/@codesandbox/sandpack-react/dist/index.mjs 266.6 KiB
./src/components/ProductComparisonTable/index.tsx + 114 modules 264.0 KiB
./node_modules/.pnpm/d3@7.9.0/node_modules/d3/src/index.js + 208 modules 247.4 KiB
./src/components/Pricing/PricingSlider/Slider.tsx + 87 modules 239.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.

@github-actions

Copy link
Copy Markdown
Contributor

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.

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

Copy link
Copy Markdown
Contributor

This PR was closed due to lack of activity. Feel free to reopen if it's still relevant.

@github-actions github-actions Bot closed this Jul 29, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

stale This pull request has been marked as stale and will be closed soon automatically

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants