npm package Build Status Downloads Issues Semantic Release

Lazy load and hydrate component on demand. Deal with Nextjs performance without compromise.

This package is heavily based on

Before After
Screen Shot 2022-06-05 at 22 31 29 Screen Shot 2022-06-05 at 22 31 19
Live check PageSpeed Live check PageSpeed

Read more about Islands Architecture here


npm install next-lazy-hydrate


import lazyHydrate from 'next-lazy-hydrate';

// Lazy hydrate when scroll into view
const WhyUs = lazyHydrate(() => import('../components/whyus'));

// Lazy hydrate when users hover into the view
const Footer = lazyHydrate(
  () => import('../components/footer', { on: ['hover'] })

const HomePage = () => {
  return (
      <AboveTheFoldComponent />
      {/* ----The Fold---- */}
      <WhyUs />
      <Footer />

Demo how to use it


lazyHydrate(dynamicImport, options?)


Type: () => Promise<React.ComponentType>

A function return import() in dynamic loading type


on: Array

An array of events who will trigger the hydration. Can contains event names directly or as an array of ['event name', options].

import lazyHydrate from 'next-lazy-hydrate'

const Card = lazyHydrate(
  () => import("../Card"),
      on: ["visible", ["scroll", () => document], ["delay", 5000]],

Support all DOM events and more :

Event name Options Description
all DOM events getTarget: Function who return the event target (default: the wrapped component)
delay delay: Number in ms (default value: 2000) Scheduled hydration.
visible getOptions: Function who return an intersectionObserver options object (default: no options) Requires IntersectionObserver. Polyfill not included. If unsupported the component is directy hydrated.
idle Requires requestIdleCallback. Polyfill not included. If unsupported the component will be hydrated with a delay of 2000ms.

whenInputPending: Boolean (optional, default: false)

When set to true use navigator.scheduling.isInputPending to check if there is a pending user input on mount. If that’s the case, hydration will be delayed using the strategies defined in the on option to allow the browser to handle the user input. If there is no pending input, the component will be hydrated directly to be interactive as fast as possible.

See for more infos.

isInputPendingFallbackValue: Boolean (optional, default: true)

The default value returned on browsers who don’t implements navigator.scheduling.isInputPending when whenInputPending set to true.

disableFallback: Boolean (optional, default: false)

If set at true the component will not be rendered client side if not rendered server side.


wrapperProps: Object (optional)

Props that are applied to the div which wraps the provided component.

import lazyHydrate from 'next-lazy-hydrate';
import Card from "../Card";

const Card = lazyHydrate(
  () => import("../Card"),
      on: ["delay"],

export default class App extends React.Component {
    render() {
        return (
                title="my card"
                    className: "customClassName",
                    style: { display: "contents" },

forceHydration: Boolean (optional, default: false)

Force the hydration of the component.


Type: string Default: rainbows

Lorem ipsum.


View Github