9f9214abe5
This PR updates the docs and examples for `create-next-app` to include pnpm usage. The following script was used to update every example README: ```js const fs = require('fs') const examples = fs.readdirSync('./examples') for (let example of examples) { const filename = `./examples/${example}/README.md` const markdown = fs.readFileSync(filename, 'utf8') const regex = new RegExp(`^yarn create next-app --example (.*)$`, 'gm') const output = markdown.replace(regex, (yarn, group) => { const pnpm = `pnpm create next-app -- --example ${group}` return `${yarn}\n# or\n${pnpm}` }) fs.writeFileSync(filename, output) } ``` |
||
---|---|---|
.. | ||
pages | ||
.gitignore | ||
package.json | ||
README.md |
Server-Side Rendering Caching Headers
This example uses stale-while-revalidate
cache-control headers in combination with getServerSideProps
for server-rendering.
pages/index.js
uses getServerSideProps
to forward the request header to the React component, as well as setting a response header. This cache-control
header uses stale-while-revalidate
to cache the server response.
pages/index.js
is considered fresh for ten seconds (s-maxage=10
). If a request is repeated within the next 10 seconds, the previously cached value will still be fresh. If the request is repeated before 59 seconds, the cached value will be stale but still render (stale-while-revalidate=59
).
In the background, a revalidation request will be made to populate the cache with a fresh value. If you refresh the page, you will see the new value shown.
Deploy your own
Deploy the example using Vercel or preview live with StackBlitz
How to use
Execute create-next-app
with npm or Yarn to bootstrap the example:
npx create-next-app --example ssr-caching ssr-caching-app
# or
yarn create next-app --example ssr-caching ssr-caching-app
# or
pnpm create next-app -- --example ssr-caching ssr-caching-app
Deploy it to the cloud with Vercel (Documentation).