auth0-nextjs

Add Auth0 authentication to Next.js apps with session management, protected routes, and middleware. Add authentication to Next.js applications using @auth0/nextjs-auth0. Supports both App Router and Pages Router. For automated setup with Auth0 CLI , see Setup Guide for complete scripts. For manual setup: Create .env.local : Generate secret: openssl rand -hex 32 Important: Add .env.local to .gitignore Detect project structure first: Check whether the project uses a src/ directory (i.e. src/app/ or src/pages/ exists). This determines where to place files: Create lib/auth0.ts (or src/lib/auth0.ts if using the src/ convention): Middleware Configuration (Next.js 15 vs 16): Next.js 15 - Create middleware.ts (at project root, or src/middleware.ts if using src/ ): Next.js 16 - You have two options: Option 1: Use middleware.ts (same as Next.js 15, same src/ placement rules): Option 2: Use proxy.ts (at project root, or src/proxy.ts if using src/ ): This automatically creates endpoints: Note: In v4, wrapping with is optional. Only needed if you want to pass an initial user during server rendering to useUser() . App Router - Optionally wrap app in app/layout.tsx : Pages Router - Optionally wrap app in pages/_app.tsx : Client Component (works in both routers): Start your dev server: Visit and test the login flow.