ts-monorepo

Manage TypeScript monorepo operations:

1. Detect Monorepo Setup

   Check for monorepo configuration:

   • pnpm: pnpm-workspace.yaml
   • npm: package.json workspaces
   • Yarn: yarn workspaces in package.json
   • Nx: nx.json
   • Turborepo: turbo.json
   • Lerna: lerna.json

2. Command Router

   Based on $ARGUMENTS:

   • init - Initialize TypeScript monorepo
   • references - Set up project references
   • build - Build all packages in dependency order
   • test - Run tests across workspace
   • clean - Clean all build artifacts
   • deps - Analyze dependencies between packages
   • add - Add new package to monorepo
   • (no args) - Show monorepo status

Command: init

Initialize TypeScript monorepo from scratch:

1. Choose Package Manager

• Recommend pnpm for best TypeScript support
• Support npm workspaces, Yarn, or pnpm

2. Create Workspace Structure

monorepo/
├── packages/
│   ├── core/           # Shared utilities
│   ├── ui/             # UI components
│   └── app/            # Main application
├── package.json        # Root package
├── pnpm-workspace.yaml # Workspace config
├── turbo.json          # Build orchestration
└── tsconfig.base.json  # Shared TS config

3. Configure Root Package

{
  "name": "monorepo-root",
  "private": true,
  "workspaces": ["packages/*"],
  "scripts": {
    "build": "turbo run build",
    "test": "turbo run test",
    "type-check": "turbo run type-check",
    "clean": "turbo run clean"
  },
  "devDependencies": {
    "typescript": "^5.5.0",
    "turbo": "^2.0.0"
  }
}

4. Create Workspace Config

# pnpm-workspace.yaml
packages:
  - 'packages/*'

5. Set Up Base TypeScript Config

// tsconfig.base.json
{
  "compilerOptions": {
    "target": "ES2020",
    "module": "ESNext",
    "lib": ["ES2020"],
    "moduleResolution": "bundler",
    "strict": true,
    "esModuleInterop": true,
    "skipLibCheck": true,
    "composite": true,
    "declaration": true,
    "declarationMap": true,
    "sourceMap": true,
    "incremental": true
  }
}

6. Configure Turborepo

// turbo.json
{
  "$schema": "https://turbo.build/schema.json",
  "pipeline": {
    "build": {
      "dependsOn": ["^build"],
      "outputs": ["dist/**", ".next/**"]
    },
    "test": {
      "dependsOn": ["build"]
    },
    "type-check": {
      "dependsOn": ["^build"]
    },
    "clean": {
      "cache": false
    }
  }
}