SSR page flickers on load and wipes typed text in form inputs
Divergent server/client trees trigger React hydration bailout, discarding SSR DOM nodes and resetting any user input entered before JS finished booting.
Warning: Text content did not match. Server vs Client / Hydration failed because the initial UI does not match what was rendered on the serverCausal Chain of Browser Mechanisms
Ordered from trigger to root invariant. Open any mechanism to inspect its internals or reproduce the behavior in an interactive lab.
Streams the HTML <head> and shell immediately over HTTP/2+ while slow backend queries run, then flushes deferred <template> chunks for out-of-order DOM replacement.
Contrasts eager SSR hydration—which replays component trees on the client to attach listeners—with resumability, which serializes state in HTML and loads handlers lazily.
One mismatched timestamp or browser-extension node during SSR hydration can discard the server DOM and force a synchronous client re-render. Understanding cursor matching and Suspense bailout boundaries keeps LCP and INP intact.
Persists shareable, reload-safe view state (filters, tabs, pagination) in URLSearchParams—using pushState for discrete steps and replaceState for continuous edits.
Linear regex arrays stall route matching on large apps and leak stale navigation fetches. Radix-tree routers resolve paths in O(path_length), abort superseded loaders, and integrate with browser navigation primitives.