> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.com/auth0/nextjs-auth0/llms.txt
> Use this file to discover all available pages before exploring further.
# Introduction
> Next.js SDK for signing in with Auth0
Auth0 Next.js SDK
A powerful SDK for implementing user authentication in Next.js applications with Auth0
## What is Auth0 Next.js SDK?
The Auth0 Next.js SDK is a library for implementing user authentication in Next.js applications. It provides both client-side and server-side APIs to integrate Auth0 authentication seamlessly into your Next.js app, supporting both the App Router and Pages Router.
Get authentication up and running in minutes with minimal configuration
Built-in security best practices including encrypted session cookies and CSRF protection
Complete type definitions for all APIs and configuration options
Choose between stateless cookie-based sessions or stateful external storage
## Key Features
Works seamlessly with both Next.js App Router and Pages Router, supporting Next.js 14, 15, and 16.
React hooks like `useUser()` for client-side usage and `Auth0Client` for server-side operations.
Supports DPoP (Demonstrating Proof-of-Possession) for token binding and Multi-Factor Authentication (MFA).
Manage multiple access tokens for different APIs with automatic token refresh per audience.
Flexible session configuration with support for rolling sessions, custom session stores, and session hooks.
Built-in proxy support for Auth0's My Account and My Organization Management APIs.
## How It Works
The SDK intercepts authentication requests at the network boundary using Next.js middleware (or proxy in Next.js 16) and handles the complete OAuth 2.0 / OIDC flow:
```mermaid theme={null}
sequenceDiagram
participant User
participant App
participant Middleware
participant Auth0
User->>App: Access protected page
App->>Middleware: Check session
Middleware->>Middleware: No session found
Middleware->>Auth0: Redirect to /authorize
Auth0->>User: Show login page
User->>Auth0: Enter credentials
Auth0->>Middleware: Redirect to /callback
Middleware->>Auth0: Exchange code for tokens
Auth0->>Middleware: Return tokens
Middleware->>Middleware: Create encrypted session
Middleware->>App: Redirect to app
App->>User: Show protected content
```
## Package Structure
The SDK is organized into multiple entry points for different use cases:
```typescript theme={null}
import { useUser, getAccessToken, Auth0Provider } from '@auth0/nextjs-auth0';
```
Client-side React hooks and components for use in browser environments.
```typescript theme={null}
import { Auth0Client } from '@auth0/nextjs-auth0/server';
```
Server-side authentication client for use in API routes, server components, and middleware.
```typescript theme={null}
import { SdkError, AccessTokenError } from '@auth0/nextjs-auth0/errors';
```
Error classes for handling authentication failures and OAuth errors.
```typescript theme={null}
import type { SessionData, User, TokenSet } from '@auth0/nextjs-auth0/types';
```
TypeScript type definitions for sessions, users, and tokens.
## Next Steps
Install the SDK and configure your environment variables
Get a working authentication flow in under 5 minutes
Learn how authentication flows work in the SDK
Explore the complete API documentation
## Requirements
* **Node.js**: Version 20 LTS or newer
* **Next.js**: Version 14.2.35 or newer (supports 14.x, 15.x, and 16.x)
* **React**: Version 18.0.0 or newer (supports 18.x and 19.x)
* **Auth0 Account**: A free Auth0 account with a Regular Web Application configured
## Community & Support
Report bugs and request features
Get help from the Auth0 community
Report security vulnerabilities