Turborepo

turbo.json Configuration

{
  "$schema": "https://turbo.build/schema.json",
  "tasks": {
    "build": {
      "dependsOn": ["^build"],
      "outputs": ["dist/**", ".next/**", "!.next/cache/**"]
    },
    "dev": {
      "cache": false,
      "persistent": true
    },
    "lint": {},
    "test": {
      "dependsOn": ["build"]
    }
  }
}

• Use ^ prefix for topological dependencies (build dependencies first)
• Define proper outputs for caching
• Mark development tasks with cache: false and persistent: true

Caching Strategy

• Configure remote caching for CI/CD with Vercel or self-hosted solutions
• Define accurate outputs arrays to ensure proper cache hits
• Use inputs to specify which files affect task caching
• Exclude cache directories from outputs (e.g., !.next/cache/**)

Task Dependencies

• Use dependsOn to define task relationships:
  • "^build" - Run build in dependencies first
  • "lint" - Run lint in the same package
  • "@repo/ui#build" - Run build in a specific package
• Define proper task ordering for complex build pipelines

Shared Configurations

• Create shared config packages:
  • @repo/typescript-config - Shared TypeScript configurations
  • @repo/eslint-config - Shared ESLint configurations
  • @repo/tailwind-config - Shared Tailwind configurations
• Reference configs using extends or imports in workspace configs

Development Workflow

• Use turbo dev to run development servers across workspaces
• Filter commands to specific workspaces: turbo build --filter=web
• Use --filter with patterns: turbo build --filter=./apps/*
• Watch mode with turbo watch for continuous builds

CI/CD Integration

• Enable remote caching in CI for faster builds
• Use --dry-run to preview what would be executed
• Implement proper environment variable handling with globalEnv and env
• Set up GitHub Actions or other CI with Turborepo caching

Best Practices

• Keep task definitions consistent across similar workspaces
• Use workspace-level turbo.json for package-specific overrides
• Minimize root-level dependencies; install in workspaces that need them
• Document workspace purposes and relationships in README files
• Use TypeScript project references for faster type checking
• Implement incremental builds for large codebases