feat(docs): add "!.next/cache/**" everywhere (#4159)

Turbo doesn't need to cache this (it's cached by the Vercel build cache)
and can make cache unnecessarily large.

docs/pages/blog/turbo-0-4-0.mdx

@@ -173,7 +173,7 @@ Building on the example from above, you can now set cache output conventions acr
     "pipeline": {
       "build": {
         // Cache anything in dist or .next directories emitted by a `build` command
-        "outputs": ["dist/**", ".next/**"]
+        "outputs": ["dist/**", ".next/**", "!.next/cache/**"]
         "dependsOn": ["^build"]
       },
       "test": {

docs/pages/blog/turbo-1-1-0.mdx

@@ -103,7 +103,7 @@ You can now control `turbo`'s [cache fingerprinting (a.k.a. hashing)](/repo/docs
           "$NEXT_PUBLIC_STRIPE_PUBLIC_KEY",
           "$NEXT_PUBLIC_ANALYTICS_ID",
       ],
-      "outputs": [".next/**"],
+      "outputs": [".next/**", "!.next/cache/**"],
     },
     "docs#build": { // override settings for the "build" task for the "docs" app
       "dependsOn": [
@@ -113,7 +113,7 @@ You can now control `turbo`'s [cache fingerprinting (a.k.a. hashing)](/repo/docs
           "$NEXT_PUBLIC_STRIPE_PUBLIC_KEY",
           "$NEXT_PUBLIC_ANALYTICS_ID",
       ],
-      "outputs": [".next/**"],
+      "outputs": [".next/**", "!.next/cache/**"],
     }
   },
   "globalDependencies": [

docs/pages/blog/turbo-1-3-0.mdx

@@ -79,11 +79,11 @@ Let's assume that the Next.js `docs-site` renders the markdown files from the `.
     // ... omitted for brevity
     "build": {
       "dependsOn": ["^build"],
-      "outputs": [".next/**", "dist/**"]
+      "outputs": [".next/**", "!.next/cache/**", "dist/**"]
     },
     "docs#build": {
       "dependsOn": ["^build"],
-      "outputs": [".next/**"],
+      "outputs": [".next/**", "!.next/cache/**"],
       // Define set of relevant globs which impact caching of docs site
       // builds
       "inputs": [

docs/pages/blog/turbo-1-6-0.mdx

@@ -79,7 +79,7 @@ Try it out now by [starting from the example](https://github.com/vercel/turbo/tr
 {
   "pipeline": {
     "build": {
-      "outputs": [".next/**"]
+      "outputs": [".next/**", "!.next/cache/**"]
     },
     "lint": {
       "outputs": []

docs/pages/blog/turbo-1-8-0.mdx

@@ -66,7 +66,7 @@ For example, imagine your monorepo has a Next.js app and a SvelteKit app, and yo
 	"pipeline": {
 		"build": {
 			// dependsOn is inherited from root
-			"outputs": [".next/**"]
+			"outputs": [".next/**", "!.next/cache/**"]
 		}
 	}
 }

docs/pages/repo/docs/core-concepts/caching.mdx

@@ -216,7 +216,7 @@ the values of environment variables:
         "NEXT_PUBLIC_STRIPE_PUBLIC_KEY",
         "NEXT_PUBLIC_ANALYTICS_ID"
       ],
-      "outputs": [".next/**"]
+      "outputs": [".next/**", "!.next/cache/**"]
     }
   }
 }
@@ -250,7 +250,7 @@ To alter the cache for _all_ tasks, you can declare environment variables in the
         "NEXT_PUBLIC_STRIPE_PUBLIC_KEY",
         "NEXT_PUBLIC_ANALYTICS_ID"
       ],
-      "outputs": [".next/**"],
+      "outputs": [".next/**", "!.next/cache/**"],
     },
   },
 +  "globalEnv": [
@@ -376,7 +376,7 @@ invoking `turbo`!
     "build": {
       "dependsOn": ["^build"],
       "env": ["SOME_ENV_VAR"],
-      "outputs": [".next/**"],
+      "outputs": [".next/**", "!.next/cache/**"],
     },
   }
 }
@@ -401,7 +401,7 @@ To ensure you end up with the correct caching behavior for your task, add these
     "build": {
       "dependsOn": ["^build"],
       "env": ["SOME_ENV_VAR"],
-      "outputs": [".next/**"],
+      "outputs": [".next/**", "!.next/cache/**"],
     },
   }
 }

docs/pages/repo/docs/core-concepts/monorepos/configuring-workspaces.mdx

@@ -59,7 +59,7 @@ with a single `turbo.json` at the root like this:
 {
   "pipeline": {
     "build": {
-      "outputs": [".next/**", ".svelte-kit/**"],
+      "outputs": [".next/**", "!.next/cache/**", ".svelte-kit/**"],
     }
   }
 }
@@ -87,8 +87,8 @@ and remove the config from the root configuration:
 {
   "pipeline": {
     "build": {
--      "outputs": [".next/**", ".svelte-kit/**"]
-+      "outputs": [".next/**"]
+-      "outputs": [".next/**", "!.next/cache/**", ".svelte-kit/**"]
++      "outputs": [".next/**", "!.next/cache/**"]
     }
   }
 }
@@ -166,7 +166,7 @@ app again. Without a Workspace-specific task, you might configure your root
     "build": {
       "outputMode": "hash-only",
       "inputs": ["src/**"],
-      "outputs": [".next/**"],
+      "outputs": [".next/**", "!.next/cache/**"],
     },
     "my-sveltekit-app#build": {
       "outputMode": "hash-only", // must duplicate this

docs/pages/repo/docs/getting-started/add-to-project.mdx

@@ -58,7 +58,7 @@ For more information on configuring your `turbo.json`, see the [Configuration Op
   "$schema": "https://turbo.build/schema.json",
   "pipeline": {
     "build": {
-      "outputs": [".next/**"]
+      "outputs": [".next/**", "!.next/cache/**"]
     },
     "lint": {}
   }

docs/pages/repo/docs/getting-started/create-new.mdx

@@ -325,7 +325,7 @@ Let's take a look inside `turbo.json`, at the root:
     "build": {
 //   ^^^^^
       "dependsOn": ["^build"],
-      "outputs": ["dist/**", ".next/**"]
+      "outputs": ["dist/**", ".next/**", "!.next/cache/**"]
     },
     "lint": {},
     "dev": {
@@ -448,7 +448,7 @@ Take a look inside `build` in `turbo.json`. There's some interesting config ther
 {
   "pipeline": {
     "build": {
-      "outputs": [".next/**"]
+      "outputs": [".next/**", "!.next/cache/**"]
     }
   }
 }

docs/pages/repo/docs/getting-started/existing-monorepo.mdx

@@ -107,7 +107,7 @@ Workspaces that do not have the specified script defined in their `package.json`
       "dependsOn": ["^build"],
       // note: output globs are relative to each package's `package.json`
       // (and not the monorepo root)
-      "outputs": [".next/**"]
+      "outputs": [".next/**", "!.next/cache/**"]
     },
     "test": {
       // A package's `test` script depends on that package's

docs/pages/repo/docs/handbook/building-your-app.mdx

@@ -48,7 +48,7 @@ Inside `turbo.json`, you can add `build` to the pipeline.
 {
   "pipeline": {
     "build": {
-      "outputs": [".next/**"]
+      "outputs": [".next/**", "!.next/cache/**"]
     }
   }
 }

docs/pages/repo/docs/reference/codemods.mdx

@@ -156,7 +156,7 @@ For example:
   "pipeline": {
     "build": {
       "dependsOn": ["^build", "$API_BASE"],
-      "outputs": [".next/**"]
+      "outputs": [".next/**", "!.next/cache/**"]
     },
     "lint": {},
     "dev": {
@@ -179,7 +179,7 @@ For example:
 -     "dependsOn": ["^build", "$API_BASE"],
 +     "dependsOn": ["^build"],
 +     "env": ["API_BASE"],
-      "outputs": [".next/**"],
+      "outputs": [".next/**", "!.next/cache/**"],
     },
     "lint": {},
     "dev": {
@@ -224,7 +224,7 @@ For example:
     "build": {
       "dependsOn": ["^build"],
       "env": ["API_BASE"],
-      "outputs": [".next/**"]
+      "outputs": [".next/**", "!.next/cache/**"]
     },
     "lint": {
       "outputs": []
@@ -247,7 +247,7 @@ For example:
     "build": {
       "dependsOn": ["^build"],
       "env": ["API_BASE"],
-      "outputs": [".next/**"]
+      "outputs": [".next/**", "!.next/cache/**"]
     },
 -   "lint": {
 -     "outputs": []

docs/pages/repo/docs/reference/configuration.mdx

@@ -150,12 +150,12 @@ The list of environment variables a task depends on.
     "build": {
       "dependsOn": ["^build"],
       "env": ["SOMETHING_ELSE"], // value will impact the hashes of all build tasks
-      "outputs": ["dist/**", ".next/**"]
+      "outputs": ["dist/**", ".next/**", "!.next/cache/**"]
     },
     "web#build": {
       "dependsOn": ["^build"],
       "env": ["STRIPE_SECRET_KEY"], // value will impact hash of only web's build task
-      "outputs": [".next/**"]
+      "outputs": [".next/**", "!.next/cache/**"]
     }
   },
   "globalEnv": [
@@ -202,7 +202,7 @@ logs (and treat them like an artifact).
     "build": {
       // "Cache all files emitted to workspace's dist/** or .next
       // directories by a `build` task"
-      "outputs": ["dist/**", ".next/**"],
+      "outputs": ["dist/**", ".next/**", "!.next/cache/**"],
       "dependsOn": ["^build"]
     },
     "test": {

examples/basic/turbo.json

@@ -3,7 +3,7 @@
   "globalDependencies": ["**/.env.*local"],
   "pipeline": {
     "build": {
-      "outputs": [".next/**"]
+      "outputs": [".next/**", "!.next/cache/**"]
     },
     "lint": {},
     "dev": {

examples/kitchen-sink/turbo.json

@@ -7,6 +7,7 @@
       "outputs": [
         "dist/**",
         ".next/**",
+        "!.next/cache/**",
         "build/**",
         "api/**",
         "public/build/**"

examples/non-monorepo/turbo.json

@@ -2,7 +2,7 @@
   "$schema": "https://turbo.build/schema.json",
   "pipeline": {
     "build": {
-      "outputs": [".next/**"]
+      "outputs": [".next/**", "!.next/cache/**"]
     },
     "lint": {},
     "dev": {

examples/with-changesets/turbo.json

@@ -3,7 +3,7 @@
   "globalDependencies": ["**/.env.*local"],
   "pipeline": {
     "build": {
-      "outputs": ["dist/**", ".next/**"],
+      "outputs": ["dist/**", ".next/**", "!.next/cache/**"],
       "dependsOn": ["^build"]
     },
     "test": {

examples/with-docker/turbo.json

@@ -4,7 +4,7 @@
   "globalEnv": ["PORT"],
   "pipeline": {
     "build": {
-      "outputs": ["dist/**", ".next/**", "public/dist/**"],
+      "outputs": ["dist/**", ".next/**", "!.next/cache/**", "public/dist/**"],
       "dependsOn": ["^build"],
       "env": ["NEXT_PUBLIC_API_HOST"]
     },

examples/with-npm/turbo.json

@@ -4,7 +4,7 @@
   "pipeline": {
     "build": {
       "dependsOn": ["^build"],
-      "outputs": ["dist/**", ".next/**"]
+      "outputs": ["dist/**", ".next/**", "!.next/cache/**"]
     },
     "lint": {
       "outputs": []

examples/with-prisma/turbo.json

@@ -5,7 +5,7 @@
   "pipeline": {
     "build": {
       "dependsOn": ["^build"],
-      "outputs": ["dist/**", ".next/**"]
+      "outputs": ["dist/**", ".next/**", "!.next/cache/**"]
     },
     "db:migrate:deploy": {},
     "db:push": {},

examples/with-react-native-web/turbo.json

@@ -3,7 +3,7 @@
   "globalDependencies": ["**/.env.*local"],
   "pipeline": {
     "build": {
-      "outputs": ["dist/**", ".next/**"],
+      "outputs": ["dist/**", ".next/**", "!.next/cache/**"],
       "dependsOn": ["^build"]
     },
     "dev": {

examples/with-rollup/turbo.json

@@ -2,7 +2,7 @@
   "$schema": "https://turborepo.org/schema.json",
   "pipeline": {
     "build": {
-      "outputs": ["dist/**", "build/**", ".next/**"]
+      "outputs": ["dist/**", "build/**", ".next/**", "!.next/cache/**"]
     },
     "lint": {
       "outputs": []

examples/with-tailwind/turbo.json

@@ -4,7 +4,7 @@
   "pipeline": {
     "build": {
       "dependsOn": ["^build"],
-      "outputs": ["dist/**", ".next/**"]
+      "outputs": ["dist/**", ".next/**", "!.next/cache/**"]
     },
     "lint": {},
     "check-types": {},

examples/with-yarn/turbo.json

@@ -3,7 +3,7 @@
   "pipeline": {
     "build": {
       "dependsOn": ["^build"],
-      "outputs": ["dist/**", ".next/**"]
+      "outputs": ["dist/**", ".next/**", "!.next/cache/**"]
     },
     "lint": {},
     "dev": {

packages/create-turbo/templates/_shared_ts/turbo.json

@@ -4,7 +4,7 @@
   "pipeline": {
     "build": {
       "dependsOn": ["^build"],
-      "outputs": ["dist/**", ".next/**"]
+      "outputs": ["dist/**", ".next/**", "!.next/cache/**"]
     },
     "lint": {
       "outputs": []

packages/eslint-plugin-turbo/docs/rules/no-undeclared-env-vars.md

@@ -19,7 +19,7 @@ Examples of **incorrect** code for this rule:
   "pipeline": {
     "build": {
       "dependsOn": ["^build"],
-      "outputs": ["dist/**", ".next/**"]
+      "outputs": ["dist/**", ".next/**", "!.next/cache/**"]
     },
     "lint": {},
     "dev": {
@@ -37,7 +37,7 @@ Examples of **correct** code for this rule:
   "pipeline": {
     "build": {
       "dependsOn": ["^build"],
-      "outputs": ["dist/**", ".next/**"]
+      "outputs": ["dist/**", ".next/**", "!.next/cache/**"]
     },
     "lint": {},
     "dev": {
@@ -53,7 +53,7 @@ Examples of **correct** code for this rule:
     "build": {
       "dependsOn": ["^build"],
       "env": ["MY_API_TOKEN"],
-      "outputs": ["dist/**", ".next/**"]
+      "outputs": ["dist/**", ".next/**", "!.next/cache/**"]
     },
     "lint": {},
     "dev": {

packages/turbo-codemod/__tests__/__fixtures__/create-turbo-config/both-configs/package.json

@@ -13,7 +13,8 @@
       },
       "build": {
         "outputs": [
-          ".next/**"
+          ".next/**",
+          "!.next/cache/**"
         ]
       },
       "lint": {

packages/turbo-codemod/__tests__/__fixtures__/create-turbo-config/both-configs/turbo.json

@@ -6,7 +6,7 @@
       "persistent": true
     },
     "build": {
-      "outputs": [".next/**"]
+      "outputs": [".next/**", "!.next/cache/**"]
     },
     "lint": {
       "outputs": []

packages/turbo-codemod/__tests__/__fixtures__/create-turbo-config/no-turbo-json-config/package.json

@@ -9,7 +9,8 @@
     "pipeline": {
       "build": {
         "outputs": [
-          ".next/**"
+          ".next/**",
+          "!.next/cache/**"
         ]
       },
       "lint": {