TanStackT
TanStack3mo ago
15 replies
faint-white

Why do I get a flash of unstyled content (FOUC) when SSR is enabled in TanStack Start?

Hey everyone! I migrated a project from Next TanStack Start and I noticed something confusing with SSR.
• When I set ssr: false for a route/component, the page loads normally and fully styled, even on refresh. (expected)
• But when ssr: true, the page first loads without any styles (unstyled HTML), and then after hydration the styles appear. It feels like a flash of unstyled content.

I always thought SSR will send fully styled HTML from the server, so the page appears complete immediately. Is this expected behavior with TanStack Start?
Probably a dumb question, anyway what’s the recommended way to properly include/extract CSS during SSR to avoid this flicker?
Was this page helpful?