MyOrg Monorepo

Production-ready full-stack monorepo with Turborepo, React, Node.js, oRPC, Prisma, Redis, and WebSocket.

🚀 Quick Start

Local Development (Recommended)

# Clone and install (Automated Prisma client generation)
pnpm install

# Setup environment
cp .env.example .env
# Edit .env with your values

# Start databases (requires Docker)
pnpm docker:up

# Run database migrations
pnpm db:migrate

# Seed database
pnpm db:seed

# Start development
pnpm dev

Docker Development (Full Containerization)

# Setup environment
cp .env.example .env

# Start everything in Docker with hot reload
pnpm docker:dev

# Or rebuild and start
pnpm docker:dev:build

Features:

• ✅ Hot reload for apps AND packages
• ✅ No local Node.js installation needed
• ✅ Consistent environment across team
• ✅ Changes reflected in 1-3 seconds

Verify Configuration:

# Windows
.\verify-hot-reload.ps1

# Linux/Mac
./verify-hot-reload.sh

See README_HOT_RELOAD.md for complete guide.

Open:

• Frontend: http://localhost:5173
• API: http://localhost:3001
• API Health: http://localhost:3001/health
• Prisma Studio: http://localhost:5555

📁 Project Structure

/
├── apps/
│ ├── api/ # Backend API (Hono + Prisma + Redis)
│ └── web/ # Frontend (Vite + React + React Query)
├── packages/
│ ├── types/ # Shared TypeScript types & Zod schemas
│ ├── db/ # Shared Database layer (Prisma)
│ ├── utils/ # Shared utilities (env, logger)
│ └── ui/ # Shared UI components (shadcn)
├── docker-compose.yml
├── turbo.json
├── pnpm-workspace.yaml
└── .github/workflows # CI/CD configurations

🛠️ Technology Stack

Layer	Technology
Monorepo	Turborepo + pnpm workspaces
Frontend	Vite, React 18, TypeScript, React Query, Zustand
UI	Tailwind CSS, shadcn/ui, Radix UI
Backend	Node.js, Hono, TypeScript
RPC	oRPC (type-safe), ArkType validation
Database	PostgreSQL, Prisma ORM
Cache	Redis (caching, rate limiting, sessions)
Auth	JWT, bcrypt, role-based access
Realtime	WebSocket with Redis pub/sub
Container	Docker, Docker Compose
CI/CD	GitHub Actions (Standardized Pipeline)
Code Quality	ESLint, Prettier, Commitlint, Lefthook

📦 Available Scripts

# Development
pnpm dev           # Start all apps in dev mode
pnpm build         # Build all packages and apps (with automated Prisma generation)
pnpm lint          # Run linting
pnpm typecheck     # Type checking

# Database
pnpm db:generate   # Generate Prisma client (triggered automatically on install)
pnpm db:migrate    # Run migrations
pnpm db:seed       # Seed database
pnpm db:studio     # Open Prisma Studio

# Docker
pnpm docker:up     # Start all containers
pnpm docker:down   # Stop all containers
pnpm docker:build  # Build production Docker images

🔐 Authentication

Default seeded users:

Email	Password	Role
admin@example.com	admin123	Admin
user@example.com	user1234	User

📡 API Endpoints

Auth

• POST /api/auth/register - Register new user
• POST /api/auth/login - Login
• GET /api/auth/me - Get current user
• POST /api/auth/logout - Logout
• POST /api/auth/refresh - Refresh token

Tasks

• GET /api/tasks - List tasks
• GET /api/tasks/:id - Get task
• POST /api/tasks - Create task
• PATCH /api/tasks/:id - Update task
• DELETE /api/tasks/:id - Delete task

Files

• POST /api/upload - Upload file
• GET /api/files - List files
• DELETE /api/files/:id - Delete file

Admin

• GET /api/admin/users - List users (admin only)
• GET /api/admin/users/:id - Get user (admin only)
• DELETE /api/admin/users/:id - Delete user (admin only)

Health

• GET /health - Health check
• GET /ready - Readiness check

🐳 Docker Deployment

The project uses multi-stage Docker builds for optimized production images.

# Build and run with Docker Compose
pnpm docker:build
pnpm docker:up

# View logs
docker-compose logs -f api

🛠️ Docker Development Environment

We provide a separate, standalone Docker environment for development that includes hot-reloading for both the API and Web applications.

# Start the development environment
pnpm docker:dev

# Rebuild containers (if dependencies change)
pnpm docker:dev:build

Access services at:

• Web: http://localhost:5173
• API: http://localhost:3001
• Prisma Studio: http://localhost:5555

⚙️ CI/CD & Commit Standards

GitHub Actions

The pipeline (.github/workflows/ci.yml) automatically:

• Installs dependencies with cached pnpm.
• Generates Prisma client types.
• Runs type-checking across the monorepo.
• Executes linting.
• Builds production Docker images on push to main.

Commit Conventions

We use @commitlint/config-conventional with relaxed rules for subjects:

• Type: feat, fix, docs, style, refactor, perf, test, build, ci, chore, revert.
• Scope: Required (e.g., feat(api): ...).
• Subject: Automated case validation is disabled to support acronyms and technical terms. Max length increased to 200 characters.

🔄 WebSocket Events

Event	Direction	Description
task.created	Server → Client	Task created
task.updated	Server → Client	Task updated
task.deleted	Server → Client	Task deleted
user.online	Server → Client	User came online
user.offline	Server → Client	User went offline
presence.list	Server → Client	Online users list

🔧 Environment Variables

See .env.example for all variables. Key ones:

DATABASE_URL=postgresql://postgres:postgres@localhost:5432/myorg
REDIS_URL=redis://localhost:6379
JWT_SECRET=your-secret-key-min-32-chars

🏃 Alternative Runtimes

See README_BUN_DENO.md for Bun and Deno support.

# Bun
bun run --filter @myorg/api dev:bun

# Deno
deno run --allow-all apps/api/src/index.deno.ts

📈 Best Practices

Cache Invalidation

• Task cache invalidated on create/update/delete
• User cache invalidated on update/delete
• Pattern-based invalidation for lists

WebSocket Scaling

• Redis pub/sub for multi-server deployments
• Heartbeat for connection health
• Automatic reconnection on client

Security

• ✅ JWT with configurable expiry
• ✅ Password hashing with bcrypt
• ✅ Role-based access control
• ✅ Rate limiting per IP/user
• ✅ Token blacklist for logout
• ✅ CORS configuration
• ✅ Helmet-like security headers

📝 License

MIT