A modern, full-stack TypeScript monorepo template built with cutting-edge technologies for scalable development.
- Node.js >= 22.14.0
- pnpm >= 9.6.0
# Clone and install
pnpm install
# Configure environment
cp .env.example .env # Edit with your configuration
# Initialize database
pnpm db:push
# Start development
pnpm devThis monorepo implements a microservices architecture with:
- Backend Services: Hono-based APIs with Better Auth
- Frontend Apps: React 19 with TanStack Router
- Shared Packages: Reusable components and utilities
- Database Layer: Drizzle ORM with PostgreSQL
- Development Tooling: Unified ESLint, Prettier, TypeScript, and Vitest configs
apps/ # Applications
├── backend/ # Microservices (Hono + TypeScript)
└── frontend/ # React applications
packages/ # Shared packages
├── auth/ # Authentication utilities
├── ui/ # React component library
└── service-discovery/ # Service registry
orms/ # Database packages
└── db-auth/ # Authentication database (Drizzle ORM)
tooling/ # Development tooling
├── eslint/ # Shared ESLint configs
├── vitest/ # Testing framework setup
└── typescript/ # TypeScript configurations
Quickly scaffold new code with Turbo generators:
pnpm turbo gen package # Create shared package
pnpm turbo gen backend # Create backend service
pnpm turbo gen frontend # Create React application
pnpm turbo gen database # Create database packageEach generator creates production-ready code with:
- Consistent configuration (ESLint, Prettier, TypeScript)
- Testing setup with Vitest
- Proper workspace integration
- Docker configuration for deployment
Comprehensive testing setup with Vitest:
pnpm test:projects # Run all tests
pnpm test:projects:watch # Watch modeFeatures:
- Shared configurations via
@repo/vitest - Coverage collection across all packages
- API testing with Hono testing utilities
- Frontend testing with jsdom environment
For detailed information, see the comprehensive documentation:
| Guide | Description |
|---|---|
| 📖 Complete Documentation | Main documentation hub |
| 🧪 Testing Framework | Vitest setup, patterns, and best practices |
| 🏗 Architecture | System design and microservices patterns |
| 🚀 Development Guide | Workflow, tooling, and commands |
| ⚡ Technology Stack | Complete technology overview |
| 🎨 Code Generators | Using Turbo generators effectively |
# Development
pnpm dev # Start all services
pnpm build # Build all packages
pnpm clean # Clean build artifacts
# Code Quality
pnpm lint # Lint all packages
pnpm format # Format all code
pnpm typecheck # Type check all packages
# Testing
pnpm test:projects # Run all tests
pnpm test:projects:watch # Test in watch mode
# Database
pnpm db:push # Push schema changes
pnpm db:studio # Open Drizzle Studio- Turborepo - Build system with caching
- pnpm - Fast package manager
- TypeScript - Type safety
- Hono - Fast web framework
- Better Auth - Authentication
- Drizzle ORM - Type-safe database
- Zod - Schema validation
- React 19 - UI framework
- TanStack Router - Type-safe routing
- Tailwind CSS - Utility-first styling
- Radix UI - Accessible components
This template includes:
- 🐳 Docker configurations for all services
- ☸️ Kubernetes deployment with Terraform
- 🔄 GitOps with ArgoCD
- 📊 Monitoring with Prometheus & Grafana
- 🔒 Security with Istio service mesh
- Read the Documentation - Comprehensive guides and tutorials
- Generate Your First Service -
pnpm turbo gen backend - Set Up Authentication - Configure Discord OAuth
- Deploy to Production - Use included Terraform modules
For detailed implementation guides, troubleshooting, and best practices, visit the complete documentation.