Repository files navigation

The example repository is maintained from amonorepo. Pull Requests should be opened againstnextauthjs/next-auth.

Open Source. Full Stack. Own Your Data.

NextAuth.js is a complete open source authentication solution.

This is an example application that shows hownext-auth is applied to a basic Next.js app.

The deployed version can be found atnext-auth-example.vercel.app

NextAuth.js is an easy to implement, full-stack (client/server) open source authentication library originally designed forNext.js andServerless. Our goal is tosupport even more frameworks in the future.

Go tonext-auth.js.org for more information and documentation.

NextAuth.js is not officially associated with Vercel or Next.js.

git clone https://github.com/nextauthjs/next-auth-example.gitcd next-auth-examplepnpm install

Copy the .env.local.example file in this directory to .env.local (which will be ignored by Git):

cp .env.local.example .env.local

Add details for one or more providers (e.g. Google, Twitter, GitHub, Email, etc).

A database is needed to persist user accounts and to support email sign in. However, you can still use NextAuth.js for authentication without a database by using OAuth for authentication. If you do not specify a database,JSON Web Tokens will be enabled by default.

Youcan skip configuring a database and come back to it later if you want.

For more information about setting up a database, please check out the following links:

• Docs:authjs.dev/reference/core/adapters

1. Review and update options inauth.ts as needed.

2. When setting up OAuth, in the developer admin page for each of your OAuth services, you should configure the callback URL to use a callback path of{server}/api/auth/callback/{provider}.

e.g. For Google OAuth you would use:http://localhost:3000/api/auth/callback/google

A list of configured providers and their callback URLs is available from the endpointapi/auth/providers. You can find more information athttps://authjs.dev/getting-started/providers/oauth-tutorial

1. You can also choose to specify an SMTP server for passwordless sign in via email.

To run your site locally, use:

pnpm run dev

To run it in production mode, use:

pnpm run buildpnpm run start

Follow theDeployment documentation

ISC