Turborepo starter

This is a feature-packed Turborepo starter with additional tools for modern web applications, including Auth.js 5, Stripe integration, Resend for transactional emails, and typesafe environment variables.

🚀 Quick Start

Prerequisites

• Node.js 20.x or later
• pnpm 9.x or later
• Git

Installation

# Clone the repository
git clone https://github.com/codersaadi/turborepo-shadcn.git my-app

# Navigate to the project
cd my-app

# Install dependencies
pnpm install

.env.example

DATABASE_URL="postgresql://postgres..."
NEXT_PUBLIC_HOST="http://localhost:3000"
RESEND_KEY="re_2bb..."
RESEND_AUDIENCE_ID="uuid"
GITHUB_CLIENT_ID=""
GITHUB_CLIENT_SECRET=""

GOOGLE_CLIENT_SECRET=""
GOOGLE_CLIENT_ID=""
AUTH_SECRET="XCX/Pzf7eiPgfKY2dPh/2HVC0y9dvfEAiaxTeO0QdZuSvgNjczEINYOyejFbOvFw
yGXouZXOdIfgEXkaqiM58w=="

NEXT_PUBLIC_PRICE_ID_BASIC="price_1Pq55"
NEXT_PUBLIC_PRICE_ID_PREMIUM="price_1Pq55d"

STRIPE_API_KEY="sk_test_51"
EMAIL_FROM=""

What's inside?

This Turborepo includes the following packages/apps:

Apps and Packages

• docs: a Next.js app, Fumadocs , Mdx
• web: another Next.js app
• @repo/ui: a shared React component library using shadcn/ui
• @repo/api API package with tRPC and Zod schemas
• @repo/env : shared env package , typesafe validated env.
• @repo/db : a shared database package for scaling easily.
• @repo/typescript-config: shared tsconfig.jsons used throughout the monorepo
• @repo/biome-config: shared Biome configurations for linting and formatting

Each package/app is 100% TypeScript.

Features & Utilities

This Turborepo comes packed with powerful features:

🛠️ Core Technologies

• TypeScript for robust type checking
• Next.js for modern web applications
• Strict ESM modules support
• Fuma for documentation
• Authjs formely next-auth@latest
• TRPC Trpc Quickstart
• ✉️ Email Resend for sending transactional emails, such as user invitations or notifications

🔐 Authentication & Security

• Auth.js 5
• OAuth Providers
• Type-safe User Sessions

💾 Data & API

• Typesafe API Layer
  • End-to-end type inference
  • Shared schemas between client and server
  • Strong error handling
• React Query Integration
  • Automatic caching
  • Optimistic updates
  • Background synchronization

💳 Additional Integrations

• Stripe Payments
• Resend Email
• Shadcn/UI Components

🎨 UI & Styling

• shadcn/ui for beautiful, accessible components
• Tailwind CSS for utility-first styling

🧹 Code Quality

• Biome for lightning-fast linting and formatting

📦 DevOps & Deployment

• Docker support for production deployment
• Workspace-aware commands
• Turborepo remote caching

🤝 Git Workflow

• Husky for Git hooks management
• Commitlint for conventional commit messages
• Automated pre-commit quality checks
• react-email for developing react email templates.

Commands

# Development
pnpm dev        # Start all apps in development mode
pnpm build      # Build all apps and packages

# Linting & Formatting
pnpm lint       # Lint and auto-fix all files using Biome
pnpm format     # Format root configuration files
pnpm web email # will start email server (react email dev server)

# Git Workflow
pnpm commit     # Interactive commit message builder

Project Structure

.
├── apps
│   ├── docs                 # Documentation site
│   └── web                 # Main web application
├── packages
│   ├── ui                  # Shared UI components
│   ├── api/               # Shared API & tRPC routes
│   ├── typescript-config   # Shared TypeScript configs
│   └── biome-config        # Shared Biome configs
└── package.json

🔍 Key Features

💻 tRPC & React Query

• End-to-End Typesafe
  • Shared types across client and server
  • Zero-config type inference
• Advanced Query Management
  • Automatic caching
  • Background refetching
  • Optimistic updates

🛡️ Error Handling

• Centralized error factory
• Typesafe error responses
• Detailed error metadata
• Production-ready error anonymization

🧩 Modular Architecture

• Monorepo with clear separation of concerns
• Shared configurations
• Easy scalability

UI Components

Add new shadcn/ui components to the UI package:

pnpm ui add button
pnpm ui add card
pnpm ui add dialog
# ... and more

Git Workflow

This repo enforces a consistent git workflow:

1. Stage your changes: git add .
2. Pre-commit hooks will automatically:
   • Format and lint files
   • Run type checking
   • Validate commit message format

Remote Caching

Turborepo can use Remote Caching to share cache artifacts across machines. To enable it:

npx turbo login
npx turbo link

Package Management with Fuma

This

Useful Links

Turborepo Documentation

• Tasks
• Caching
• Remote Caching
• Filtering
• Configuration Options
• CLI Usage

Tech Stack Documentation

• Biome
• shadcn/ui
• Next.js
• TypeScript

🤝 Contributing

• Fork the repository
• Create your feature branch
• Commit with conventional commits Push and open a Pull Request

Author

Created with ❤️ by Saad Bukhari

License

MIT

---

Built with Turborepo 🚀

🔗 Useful Links

Turborepo Docs tRPC Documentation React Query Guides