Next.js Full-Stack Boilerplate

A modern, feature-rich boilerplate for personal projects built with Next.js and various modern web technologies.

Features

• Next.js 15 - Latest version with App Router and React Server Components
• TypeScript - Type safety across the entire project
• Internationalization - Support for multiple languages using next-international
• Authentication - Built-in authentication with Supabase
• Database Integration - Prisma ORM with PostgreSQL database support
• UI Components - Custom UI components with Tailwind CSS and Radix UI
• Dark/Light Mode - Theme switching capability with next-themes
• Form Validation - Client and server-side validation with Yup

Tech Stack

Frontend

• Next.js 15
• React 19
• Tailwind CSS
• next-international
• next-themes
• Radix UI

Backend

• Supabase - Authentication and backend services
• Prisma - Type-safe ORM
• PostgreSQL - Database

Development Tools

• TypeScript
• Bun - Fast JavaScript runtime and package manager

Project Structure

├── actions/               # Server actions for auth and data operations
├── app/                   # Next.js app directory with routes
│   └── [locale]/          # Internationalized routes
├── components/            # React components
│   ├── main-layout/       # Layout components (header, footer, etc.)
│   ├── signin/            # Sign-in related components
│   ├── signout/           # Sign-out related components
│   ├── signup/            # Sign-up related components
│   └── ui/                # Reusable UI components
├── lib/                   # Utility functions and shared code
├── locales/               # Internationalization files
├── prisma/                # Prisma schema and configurations
│   ├── generated/         # Generated Prisma client
│   └── migrations/        # Database migrations
├── public/                # Static files
└── supabase/              # Supabase configuration

Getting Started

Prerequisites

• Node.js (v18 or later)
• Bun (v1.0 or later)
• PostgreSQL database

Installation

1. Clone this repository

   git clone <your-repo-url>
   cd boilerplate

2. Install dependencies

   bun install

3. Set up environment variables

   cp .env.example .env

   Then edit the .env file with your configuration details.

4. Run database migrations

   bunx prisma migrate dev

5. Start the development server

   bun dev

6. Open http://localhost:3000 to see your application

Scripts

• bun dev - Start the development server with Turbopack
• bun build - Build the application for production
• bun start - Start the production server
• bun lint - Run ESLint to check code quality

Deployment

This project can be deployed to any platform that supports Next.js applications, such as Vercel.

bun build

License

This project is available for personal use.