monorepo-template

Monorepo template with pnpm, turbo, NestJS, React (Vite), TypeORM, oRPC contracts, and a local mock S3 (s3rver).

Structure

apps/
  backend/    — NestJS API
  frontend/   — React + Vite
  bucket/     — local mock S3 (s3rver)
packages/
  shared/     — shared types and constants
  database/   — TypeORM data source and entities
  contracts/  — API contracts (oRPC)

Quick start

cp .env.example .env
pnpm install
pnpm dev

Ports

Service	Port
Frontend	3000
Backend	4001
Mock S3	4568

Scripts

Command	Description
pnpm dev	Start all apps in parallel
pnpm build	Build all packages and apps
pnpm lint	Lint all packages and apps
pnpm test	Run tests
pnpm clean	Remove build artifacts

Creating a new project

1. Use this repo as a GitHub template or clone it.
2. Find-and-replace monorepo-template with your project name.
3. Update .env with your database and S3 settings.
4. Extend packages/contracts, packages/database, and apps/backend for your domain.

Notes

• apps/bucket/data/ is gitignored — s3rver creates it at runtime.
• oRPC contracts in packages/contracts are defined but not yet wired to the NestJS backend. Connect them when you add your first API module.