A modern, production-ready Next.js boilerplate with comprehensive authentication, admin dashboard, and user management features. Built by Zexa for rapid application development.

• Email & Password Authentication with email verification
• Session Management with secure token handling
• Account Linking support
• Role-based Access Control (Admin, User roles)

• User Registration & Login with form validation
• Email Verification system
• Profile Management
• User Banning/Unbanning with expiration dates
• Session Revocation for security

• User Management Interface - View, edit, ban/unban users
• Role Assignment - Manage user permissions
• User Actions - Delete users, revoke sessions
• Responsive Admin UI with modern design

Admin Panel

• Modern Design System with Tailwind CSS
• Responsive Layout for all devices
• Component Library with Radix UI primitives
• Form Validation with React Hook Form + Zod
• Toast Notifications for user feedback

• Framework: Next.js 16 with App Router
• Authentication: Better Auth
• Database: PostgreSQL with Drizzle ORM
• Styling: Tailwind CSS
• UI Components: Radix UI
• Form Handling: React Hook Form
• Validation: Zod
• Email: Resend
• TypeScript: Full type safety

• Node.js 18+
• PostgreSQL database
• Resend account (for email functionality)

1. Clone the repository

   git clone <repository-url>
   cd zexa-auth-starter

2. Install dependencies

   pnpm install

3. Environment Setup

   Copy the .env.example file to .env.local and fill in the values.

   cp .env.example .env.local

4. Database Setup

   # Generate and run migrations
   pnpm db:generate
   pnpm db:migrate

5. Start Development Server

   pnpm dev

Visit http://localhost:3000 to see your application!

src/
├── app/                    # Next.js App Router
│   ├── admin/             # Admin dashboard pages
│   ├── api/               # API routes
│   ├── auth/              # Authentication pages
│   └── dashboard/         # User dashboard
├── components/            # React components
│   ├── admin/            # Admin-specific components
│   ├── auth/             # Authentication forms
│   ├── landing/          # Landing page components
│   └── ui/               # Reusable UI components
├── db/                   # Database configuration
├── lib/                  # Utility libraries
└── utils/                # Helper functions

• pnpm dev - Start development server with Turbopack
• pnpm build - Build for production
• pnpm start - Start production server
• pnpm lint - Run ESLint
• pnpm db:generate - Generate database migrations
• pnpm db:migrate - Run database migrations
• pnpm db:push - Push database migrations to the database
• pnpm db:studio - Open the Drizzle ORM Studio

1. Registration: Users sign up with email/password
2. Email Verification: Automated email verification process
3. Login: Secure session-based authentication

• User Management: Full CRUD operations on user accounts
• Role Management: Assign and modify user roles
• Security Actions: Ban users, revoke sessions, delete accounts
• Audit Trail: Track user actions and changes

1. Push your code to GitHub
2. Connect your repository to Vercel
3. Add environment variables in Vercel dashboard
4. Deploy!

Contributions are welcome! Please feel free to submit a Pull Request.

This project is licensed under the MIT License - see the LICENSE file for details.

For support and questions:

• Create an issue in this repository
• Contact Zexa team

Built with ❤️ by Zexa

Ready to build something amazing? Get started with Zexa Auth Starter today!