next.js/examples/progressive-render/README.md

Example app implementing progressive server-side render

How to use

Using create-next-app

Download create-next-app to bootstrap the example:

npm i -g create-next-app
create-next-app --example progressive-render progressive-render-app

Download manually

Download the example or clone the repo:

curl https://codeload.github.com/zeit/next.js/tar.gz/canary | tar -xz --strip=2 next.js-canary/examples/progressive-render
cd progressive-render

Install it and run:

npm install
npm run dev

Deploy it to the cloud with now (download)

now

The idea behind the example

Sometimes you want to not server render some parts of your application. That can be third party components without server render capabilities, components that depends on window and other browser only APIs or just because that content isn't important enough for the user (eg. below the fold content).

In that case you can wrap the component in react-no-ssr which will only render the component client-side.

This example features:

• An app with a component that must only be rendered in the client
• A loading component that will be displayed before rendering the client-only component

Example: https://progressive-render-raceuevkqw.now.sh/