rsnext/examples/catch-all-routes/README.md
Steven 9f9214abe5
Updated create-next-app docs to include pnpm usage (#35755)
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)
}
```
2022-03-30 21:03:21 +00:00

1.6 KiB

Catch All Routes Example

This example shows how to use Catch all routes in Next.js, which allows a dynamic route to catch all paths.

The catch all page is in pages/post/[...slug], it matches any path after /post, like the following:

  • /post/first-post,
  • /post/2020/first-post
  • /post/2020/first-post/with/catch/all/routes
  • Anything that matches the glob /post/**

You can use next/link as displayed in this example to route to these pages client side.

Deploy your own

Deploy the example using Vercel or preview live with StackBlitz

Deploy with Vercel

How to use

Execute create-next-app with npm or Yarn to bootstrap the example:

npx create-next-app --example catch-all-routes catch-all-routes-app
# or
yarn create next-app --example catch-all-routes catch-all-routes-app
# or
pnpm create next-app -- --example catch-all-routes catch-all-routes-app

Deploy it to the cloud with Vercel (Documentation).