turbo

<objective> Configure Turborepo for efficient monorepo builds with task pipelines, remote caching, and proper package dependencies. </objective>

<mcp_first> CRITICAL: Always fetch Turborepo documentation for current configuration.

MCPSearch({ query: "select:mcp__plugin_devtools_context7__query-docs" })

// Task configuration
mcp__context7__query_docs({
  libraryId: "/vercel/turborepo",
  query: "How do I configure tasks with dependsOn, outputs, and inputs?",
});

// Caching
mcp__context7__query_docs({
  libraryId: "/vercel/turborepo",
  query: "How do I configure cache outputs and remote caching?",
});

// Filtering
mcp__context7__query_docs({
  libraryId: "/vercel/turborepo",
  query: "How do I filter workspaces and packages?",
});

Note: Context7 v2 uses server-side filtering. Use descriptive natural language queries. </mcp_first>

<quick_start> turbo.json:

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

Key concepts:

• ^build - Run build in dependencies first
• outputs - Files to cache
• inputs - Files that affect cache key
• cache: false - Disable caching for dev tasks
• persistent: true - Long-running tasks </quick_start>

<task_patterns> Build pipeline:

{
  "tasks": {
    "build": {
      "dependsOn": ["^build"],
      "outputs": ["dist/**"],
      "inputs": ["src/**", "package.json", "tsconfig.json"]
    }
  }
}

Test after build:

{
  "tasks": {
    "test": {
      "dependsOn": ["build"],
      "outputs": ["coverage/**"]
    }
  }
}

Parallel independent tasks:

{
  "tasks": {
    "lint": {
      "outputs": []
    },
    "typecheck": {
      "outputs": []
    }
  }
}

</task_patterns>

<commands> ```bash turbo build # Build all packages turbo build --filter=@org/app # Build specific package turbo build --filter=./apps/* # Build apps only turbo build --filter=...@org/lib # Package and dependents turbo build --force # Ignore cache turbo build --dry-run # Preview what will run ``` </commands> <constraints> **Required:** - Define `outputs` for cacheable tasks - Use `^` prefix for dependency ordering - Set `cache: false` for dev tasks - Use `persistent: true` for long-running tasks

Best practices:

• Keep inputs specific to avoid cache misses
• Use workspace filters for targeted builds
• Enable remote caching for CI </constraints>

<success_criteria>

• Context7 docs fetched for current config
• Tasks have proper dependsOn
• outputs defined for cacheable tasks
• Dev tasks have cache: false
• Pipeline is efficient (parallel where possible) </success_criteria>