NextJS Boilerplate

A modern, type-safe, and production-ready Next.js boilerplate for building applications.

🚀 Features

• ⚡️ Next.js 15 with App Router
• 🎨 Shadcn UI components with Radix UI primitives
• 🎯 TypeScript for type safety
• 🎨 Tailwind CSS for styling
• 🔐 Authentication with Supabase
• 📊 Analytics with OpenPanel
• 🗄️ Database with Prisma Accelerate
• 📱 Mobile-first responsive design
• 🎭 Dark mode support
• 📝 MDX support for content
• 🚀 Performance optimized
• 🔍 SEO friendly
• 🛡️ Security best practices

📦 Tech Stack

• Framework: Next.js 15
• Language: TypeScript
• Styling: Tailwind CSS
• UI Components: Shadcn UI, Radix UI
• Database: Prisma
• Authentication: Supabase
• Analytics: OpenPanel
• Rate Limiting: Upstash
• Form Handling: React Hook Form
• Validation: Zod
• State Management: React Query
• Icons: Lucide React
• Notifications: Sonner

🛠️ Getting Started

1. Clone the repository

   git clone https://github.com/yourusername/gymbrah.git
   cd gymbrah

2. Install dependencies

   pnpm install

3. Set up environment variables

   cp .env.example .env

   Fill in the required environment variables in .env

4. Run the development server

   pnpm dev

📁 Project Structure

src/
├── app/              # App router pages and layouts
├── components/       # Reusable UI components
├── lib/             # Shared utilities and configurations
├── utils/           # Helper functions
├── actions/         # Server actions
├── hooks/           # Custom React hooks
└── assets/          # Static assets

🔧 Available Scripts

• pnpm dev - Start development server
• pnpm build - Build for production
• pnpm start - Start production server
• pnpm lint - Run ESLint

🎨 UI Components

The project uses Shadcn UI components built on top of Radix UI primitives. All components are:

• Fully typed with TypeScript
• Customizable with Tailwind CSS
• Accessible by default
• Responsive and mobile-friendly

🔐 Authentication

Authentication is handled by Supabase, providing:

• Social authentication
• Session management
• Protected routes

📊 Database

The project uses Prisma as the ORM with:

• Type-safe database queries
• Migrations
• Seeding capabilities
• Database schema management

🚀 Deployment

The project is optimized for deployment on Vercel:

1. Push your code to GitHub
2. Import your repository on Vercel
3. Set up environment variables
4. Deploy!

📝 Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

📄 License

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

🙏 Acknowledgments

• Next.js
• Shadcn UI
• Radix UI
• Tailwind CSS
• Supabase
• Prisma

📞 Support

For support, reach me on X or visit federicofan.com.