A modern, production-ready full-stack web application template

Built with Next.js 15, TypeScript, Tailwind CSS, Drizzle ORM, PostgreSQL, BetterAuth, and ShadCN UI

---

🧰 Tech Stack

---

✨ Features

🔐 Authentication & Authorization

• Secure Login/Registration: Email and password authentication with validation
• Email Verification: OTP-based email confirmation system
• Role-Based Access Control: Admin, user, and guest role management
• Password Reset: Secure password reset flow with email verification
• Session Management: JWT-based session handling

🎨 User Interface

• Modern Design System: Beautiful, accessible components with ShadCN UI
• Responsive Design: Mobile-first approach with Tailwind CSS
• Dark/Light Mode: Theme switching with persistent user preferences
• Loading States: Skeleton loaders and progress indicators
• Form Validation: Real-time validation with helpful error messages

🛠️ Developer Experience

• Type Safety: Full TypeScript coverage with strict mode
• Database Management: Type-safe queries with Drizzle ORM
• Code Quality: ESLint, Prettier, and pre-commit hooks
• Hot Reload: Instant feedback during development
• API Documentation: Auto-generated API docs

🚀 Performance & Production

• Optimized Builds: Next.js optimizations for production
• Database Pooling: Connection pooling for better performance
• Caching Strategy: Built-in caching for API routes and pages
• Docker Ready: Production-ready containerization
• Health Checks: Built-in health monitoring endpoints

---

🚀 Getting Started

Prerequisites

• Node.js ≥18 - Download
• pnpm (recommended) or npm - Install pnpm
• Docker & Docker Compose - Get Docker
• Git - Install Git

Installation

1. Clone the Repository

git clone https://github.com/CianCode/Saas-Template.git
cd Saas-Template

2. Install Dependencies

pnpm install
# or
npm install

3. Environment Setup

cp .env.example .env

Update .env with your configuration:

4. Start PostgreSQL

docker compose up -d
# Wait 10–15 seconds for database to be ready

5. Set Up the Database Schema

# Push schema
pnpm db:push

# Or run migrations
pnpm db:migrate

6. Seed the Database (optional)

pnpm db:seed

7. Start Development Server

pnpm dev

Open http://localhost:3000 to see your app.

---

📁 Project Structure

Saas-Template/
├── app/                        # Next.js App Router
│   ├── (auth)/                 # Authentication pages
│   ├── api/                    # API routes
│   ├── dashboard/              # Protected pages
│   ├── globals.css             # Global styles
│   ├── layout.tsx              # Root layout
│   └── page.tsx                # Home page
├── components/                 # Reusable components
├── lib/                        # Utilities (auth, db, validations)
├── db/                         # Drizzle schema, migrations, seeds
├── hooks/                       # Custom hooks
├── types/                       # TypeScript types
├── public/                      # Static assets
├── docker-compose.yml           # Docker config
├── drizzle.config.ts            # Drizzle ORM config
├── next.config.js               # Next.js config
├── tailwind.config.ts           # Tailwind CSS config
└── tsconfig.json                # TypeScript config

---

📚 Available Scripts

🏗️ Development

pnpm dev           # Start development server
pnpm dev:debug     # Start dev server in debug mode
pnpm dev:clean     # Clean & start fresh dev server

📦 Build & Production

pnpm build         # Build app for production
pnpm start         # Start production server

🧹 Linting

pnpm lint          # Run linter
pnpm lint:fix      # Lint & auto-fix issues
pnpm lint:strict   # Lint in strict mode (no warnings)

🗄️ Database

pnpm db:generate   # Generate Drizzle migrations
pnpm db:push       # Push schema to DB
pnpm db:migrate    # Run migrations
pnpm db:studio     # Open Drizzle Studio
pnpm db:seed       # Seed DB with initial data
pnpm db:reset      # Reset DB & seed fresh data

🎨 ShadCN UI

pnpm ui:add        # Add a new component
pnpm ui:update     # Update components

---

🤝 Contributing

See CONTRIBUTING.md.

1. Fork the repository
2. Create feature branch
3. Add changes & tests
4. Commit & push
5. Open Pull Request

---

📄 License

MIT License — see LICENSE

---

🙏 Acknowledgments

• Next.js
• ShadCN UI
• Drizzle ORM
• BetterAuth
• Tailwind CSS

---

🌟 Show Your Support

• ⭐ Star the repo
• 🍴 Fork it
• 📢 Share with others
• 🐛 Report bugs or suggest improvements

---

Built with ❤️ by CianCode

Happy coding! 🚀