Repository files navigation

Implementing authentication in Next.js, especially Email+Password authentication, can be challenging. NextAuth intentionally limits email password functionality to discourage the use of passwords due to security risks and added complexity. However, in certain projects, clients may require user password authentication. Lucia offers a flexible alternative to NextAuth.js, providing more customization options without compromising on security. This template serves as a starting point for building a Next.js app with Lucia authentication.

Lucia is less opinionated than NextAuth, offering greater flexibility for customization. While Lucia involves more setup, it provides a higher degree of flexibility, making it a suitable choice for projects requiring unique authentication configurations.

• Authentication: 💼 Support for Credential and OAuth authentication.
• Authorization: 🔒 Easily manage public and protected routes within theapp directory.
• Email Verification: 📧 Verify user identities through email.
• Password Reset: 🔑 Streamline password resets by sending email password reset links.
• Lucia + tRPC: 🔄 Similar to NextAuth with tRPC, granting access to sessions and user information through tRPC procedures.
• E2E tests: 🧪 Catch every issue before your users do with comprehensive E2E testing.
• Stripe Payment: 💳 Setup user subscriptions seamlessly with stripe.
• Email template with react-email: ✉️ Craft your email templates using React.
• PostgreSQL Database: 🛢️ Utilize a PostgreSQL database set up using Drizzle for enhanced performance and type safety.
• Database Migration: 🚀 Included migration script to extend the database schema according to your project needs.

• Next.js
• Lucia
• tRPC
• Drizzle ORM
• PostgreSQL
• Stripe
• Tailwind CSS
• Shadcn UI
• React Hook Form
• React Email
• Playwright

1. Clone this repository to your local machine.
2. Copy.env.example to.env and fill in the required environment variables.
3. Runpnpm install to install dependencies.
4. (for node v18 or lower): Uncomment polyfills forwebCrypto insrc/lib/auth/index.ts
5. Update app title, database prefix, and other parameters in thesrc/lib/constants.ts file.
6. Runpnpm db:push to push your schema to the database.
7. Executepnpm dev to start the development server and enjoy!

1. InstallPlaywright (use this command if you want to install chromium onlypnpm exec playwright install chromium --with-deps)
2. Build production files usingpnpm build
3. Runpnpm test:e2e (add --debug flag to open tests in browser in debug mode)

Add the following environment variables to yourgithub actions repository secrets -DATABASE_URL,DISCORD_CLIENT_ID,DISCORD_CLIENT_SECRET

• Update Password
• Stripe Integration

• Admin Dashboard (under consideration)
• Role-Based Access Policy (under consideration)

To contribute, fork the repository and create a feature branch. Test your changes, and if possible, open an issue for discussion before submitting a pull request. Follow project guidelines, and welcome feedback to ensure a smooth integration of your contributions. Your pull requests are warmly welcome.