next.js/examples/with-shallow-routing/README.md

Shallow Routing Example

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 with-shallow-routing with-shallow-routing-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/with-shallow-routing
cd with-shallow-routing

Install it and run:

npm install
npm run dev

Deploy it to the cloud with now (download)

now

The idea behind the example

With shallow routing, we could change the URL without actually running the getInitialProps every time you change the URL.

We do this passing the shallow: true option to Router.push or Router.replace.