create-beerpal-start

BeerPal Start

A comprehensive starter template for building modern web applications with Next.js, featuring authentication, database integration, and UI components.

Features

• Next.js 15 - The latest version of Next.js with App Router
• TypeScript - Type safety for your codebase
• Tailwind CSS - Utility-first CSS framework
• shadcn/ui - High-quality UI components built with Radix UI and Tailwind CSS
• Prisma - Type-safe database ORM
• PostgreSQL - Robust relational database
• NextAuth.js v5 - Authentication for Next.js applications
• Authentication Options:
  • Email/Password login
  • Magic link authentication
  • Forgot password functionality
• Resend - Email delivery service for magic links and password reset

Getting Started

Prerequisites

• Node.js 18.17 or later
• PostgreSQL database

Installation

1. Clone this repository or use it as a template:

# Using npx
npx create-beerpal-start my-app

# Using yarn
yarn create beerpal-start my-app

# Using pnpm
pnpm dlx create-beerpal-start my-app

# Using bun
bunx create-beerpal-start my-app

2. Navigate to the project directory:

cd my-app

3. Install dependencies:

npm install
# or
yarn install
# or
pnpm install
# or
bun install

4. Set up your environment variables:

cp .env.template .env.local

Edit .env.local with your own values.

5. Set up the database:

npx prisma migrate dev --name init
# or
yarn prisma migrate dev --name init
# or
pnpm prisma migrate dev --name init
# or
bunx prisma migrate dev --name init

6. Start the development server:

npm run dev
# or
yarn dev
# or
pnpm dev
# or
bun dev

Open http://localhost:3000 with your browser to see the result.

Project Structure

├── prisma/               # Prisma schema and migrations
├── public/               # Static assets
├── src/
│   ├── app/              # Next.js App Router
│   ├── components/       # React components
│   │   ├── auth/         # Authentication components
│   │   └── ui/           # UI components (shadcn/ui)
│   └── lib/              # Utility functions and shared code
│       ├── auth.ts       # NextAuth configuration
│       ├── prisma.ts     # Prisma client
│       └── email.ts      # Email service with Resend
├── .env.template         # Template for environment variables
├── next.config.ts        # Next.js configuration
└── tailwind.config.js    # Tailwind CSS configuration

Authentication

This starter includes a complete authentication system with:

• Email/Password login
• Magic link authentication
• Password reset functionality
• User registration

Database

The starter uses Prisma with PostgreSQL. The schema includes models for:

• Users
• Accounts (for OAuth providers)
• Sessions
• Verification tokens

UI Components

The starter includes shadcn/ui components:

• Button
• Input
• Label
• Toast
• And more...

License

MIT