{"record":{"id":"815a3d6bfb5a7f92","repo":"vercel/turborepo","slug":"33m-turbo-ignore-is-deprecated-use-vercel-s-bu","errorCode":null,"errorMessage":"\u001b[33m\"turbo-ignore\" is deprecated. Use Vercel's built-in project skipping instead.\u001b[39m","messagePattern":"\u001b\\[33m\"turbo-ignore\" is deprecated\\. Use Vercel's built-in project skipping instead\\.\u001b\\[39m","errorType":"console","errorClass":null,"httpStatus":null,"severity":"warning","filePath":"packages/turbo-ignore/src/ignore.ts","lineNumber":46,"sourceCode":"  log(\"✓ Proceeding with deployment\");\n  return process.exit(1);\n}\n\nexport function turboIgnore(\n  workspaceArg: TurboIgnoreArg,\n  opts: TurboIgnoreOptions\n) {\n  opts.telemetry?.trackCommandStatus({ command: \"ignore\", status: \"start\" });\n  opts.telemetry?.trackArgumentWorkspace(workspaceArg !== undefined);\n  trackOptions(opts);\n\n  const inputs = {\n    workspace: workspaceArg,\n    ...opts\n  };\n\n  if (process.env.VERCEL === \"1\") {\n    warn(\n      `\\u001B[33m\"turbo-ignore\" is deprecated. Use Vercel's built-in project skipping instead.\\u001B[39m`\n    );\n    warn(\n      `\\u001B[33mLearn more: https://vercel.com/docs/monorepos#skipping-unaffected-projects\\u001B[39m\\n`\n    );\n  } else {\n    warn(\n      `\\u001B[33m\"turbo-ignore\" is deprecated. Use \"turbo query affected\" instead.\\u001B[39m`\n    );\n    warn(\n      `\\u001B[33mLearn more: https://turborepo.dev/docs/reference/query#migrating-from-turbo-ignore\\u001B[39m\\n`\n    );\n  }\n\n  info(\n    `Using Turborepo to determine if this project is affected by the commit...\\n`\n  );\n","sourceCodeStart":28,"sourceCodeEnd":64,"githubUrl":"https://github.com/vercel/turborepo/blob/f9245100cf0d31d96628804ead485f6bf226e55a/packages/turbo-ignore/src/ignore.ts#L28-L64","documentation":"turbo-ignore prints this deprecation warning when it detects Vercel's build environment (process.env.VERCEL === '1'): on Vercel you should use the platform's built-in skipping of unaffected projects instead of shelling out to turbo-ignore. The check still executes normally afterwards; note the warning text hardcodes yellow ANSI escapes regardless of TTY or color settings.","triggerScenarios":"A Vercel project whose Ignored Build Step / Build Command is configured to run turbo-ignore, so the process starts with VERCEL=1 and takes the Vercel branch of the deprecation messaging.","commonSituations":"Older Vercel monorepo setups that used turbo-ignore to skip unaffected app builds before built-in monorepo skipping existed.","solutions":["Remove turbo-ignore from Vercel's Ignored Build Step / Build Command and rely on Vercel's automatic project skipping","If you must keep it temporarily, accept the warning — it is informational only","Follow the linked docs (vercel.com/docs/monorepos#skipping-unaffected-projects) for the migration"],"exampleFix":"# before: Vercel Ignored Build Step\nnpx turbo-ignore\n\n# after: set Ignored Build Step to 'Auto' (or leave empty) and let Vercel skip unaffected projects natively","handlingStrategy":"fallback","validationCode":"# On Vercel, don't call turbo-ignore at all\nif [ \"$VERCEL\" = \"1\" ]; then\n  echo \"using Vercel built-in skipping\"\n  exit 0\nfi\nturbo-ignore","typeGuard":null,"tryCatchPattern":null,"preventionTips":["Audit Vercel project settings for turbo-ignore in Ignored Build Step / Build Command","Leave Ignored Build Step set to 'Auto' so Vercel skips unaffected projects natively","Grep CI configs periodically for deprecated commands like turbo-ignore"],"tags":["turbo-ignore","deprecation","vercel"],"backgroundTag":"deprecated-command-usage","analyzedSha":"f9245100cf0d31d96628804ead485f6bf226e55a","analyzedAt":"2026-08-17T10:46:15.696Z","contentChangedAt":null,"schemaVersion":2},"datasetVersion":"2026-09-14T00:17:10.932Z"}