progressive-hydration

Defer non-critical JavaScript in SSR React apps to improve Time to Interactive.

235|25|Updated Mar 24, 2026
One-click install
npx skills add https://github.com/PatternsDev/skills --skill progressive-hydration
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: progressive-hydration
Source: https://github.com/PatternsDev/skills/tree/main/react/progressive-hydration
Command: npx skills add https://github.com/PatternsDev/skills --skill progressive-hydration

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Progressive hydration bridges the gap between fast server-rendered pages and immediate interactivity by deferring non-critical JavaScript until needed, improving Time to Interactive.

Core Features & Use Cases

  • Code-splitting and lazy loading to reduce initial payload and hydrate components on demand.
  • Selective hydration that prioritizes user-visible interactions or components in view.
  • Suspense boundaries to provide graceful fallbacks while non-critical chunks load.
  • Easy integration with Next.js via dynamic imports with ssr options and with React projects using lazy().

Quick Start

Install the progressive-hydration pattern in your React app and wrap non-critical components with boundaries so they hydrate progressively after the initial render.

Frequently Asked Questions about progressive-hydration

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
What is progressive hydration in React server-side rendering?

Selective hydration prioritizes user-visible components or interactions currently in view, allowing React to defer hydration of off-screen elements and reduce the initial JavaScript execution payload.

How do I implement lazy loading and code-splitting for SSR components?

You can implement lazy loading and code-splitting in SSR by wrapping non-critical components with Suspense boundaries and using React lazy() or Next.js dynamic imports to hydrate them progressively after initial render.

Can I use progressive hydration with Next.js dynamic imports?

Yes, progressive hydration integrates easily with Next.js by utilizing dynamic imports configured with ssr options, enabling server-rendered pages to defer non-critical JavaScript loading until components require interactivity.

Do I need React Suspense to set up selective hydration boundaries?

Yes, setting up selective hydration boundaries requires React with Suspense and lazy support to provide graceful fallbacks while non-critical JavaScript chunks load on demand during the hydration process.

Why does my server-rendered React app have a slow Time To Interactive?

A slow Time To Interactive often occurs when the entire JavaScript payload hydrates simultaneously, blocking user interactions until completion, a problem progressive hydration solves by deferring non-critical chunks.