rsnext/examples/with-clerk
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
..
components Use new @clerk/nextjs package in with-clerk example, update Next.js authentication docs (#28906) 2021-09-17 10:54:34 -05:00
pages Use new @clerk/nextjs package in with-clerk example, update Next.js authentication docs (#28906) 2021-09-17 10:54:34 -05:00
public Use new @clerk/nextjs package in with-clerk example, update Next.js authentication docs (#28906) 2021-09-17 10:54:34 -05:00
styles Use new @clerk/nextjs package in with-clerk example, update Next.js authentication docs (#28906) 2021-09-17 10:54:34 -05:00
.env.local.example Use new @clerk/nextjs package in with-clerk example, update Next.js authentication docs (#28906) 2021-09-17 10:54:34 -05:00
.gitignore Add .gitignore to examples that lack them (#28003) 2021-08-12 16:47:14 -05:00
package.json Use new @clerk/nextjs package in with-clerk example, update Next.js authentication docs (#28906) 2021-09-17 10:54:34 -05:00
README.md Updated create-next-app docs to include pnpm usage (#35755) 2022-03-30 21:03:21 +00:00

Clerk and Next.js Example

This example shows how to use Clerk with Next.js. The example features adding sign up, sign in, profile management, and an authenticated API route to your Next.js application.

Demo

A hosted demo of this example is available at clerk-nextjs-example.vercel.app

Deploy your own

Deploy the example using Vercel:

Deploy with Vercel

How to use

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

npx create-next-app --example with-clerk with-clerk-app
# or
yarn create next-app --example with-clerk with-clerk-app
# or
pnpm create next-app -- --example with-clerk with-clerk-app

To run the example locally you need to:

  1. Sign up at Clerk.dev.
  2. Go to Clerk's dashboard and create an application.
  3. Set the required Clerk environment variables from your Clerk project as shown at the example env file.
  4. yarn to install the required dependencies.
  5. yarn dev to launch the development server.

Learn More

To learn more about Clerk.dev and Next.js, take a look at the following resources: