[33m"turbo-ignore" is deprecated. Use Vercel's built-in pro

Error message

[33m"turbo-ignore" is deprecated. Use Vercel's built-in project skipping instead.[39m

What it means

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.

Source

Thrown at packages/turbo-ignore/src/ignore.ts:46

  log("✓ Proceeding with deployment");
  return process.exit(1);
}

export function turboIgnore(
  workspaceArg: TurboIgnoreArg,
  opts: TurboIgnoreOptions
) {
  opts.telemetry?.trackCommandStatus({ command: "ignore", status: "start" });
  opts.telemetry?.trackArgumentWorkspace(workspaceArg !== undefined);
  trackOptions(opts);

  const inputs = {
    workspace: workspaceArg,
    ...opts
  };

  if (process.env.VERCEL === "1") {
    warn(
      `\u001B[33m"turbo-ignore" is deprecated. Use Vercel's built-in project skipping instead.\u001B[39m`
    );
    warn(
      `\u001B[33mLearn more: https://vercel.com/docs/monorepos#skipping-unaffected-projects\u001B[39m\n`
    );
  } else {
    warn(
      `\u001B[33m"turbo-ignore" is deprecated. Use "turbo query affected" instead.\u001B[39m`
    );
    warn(
      `\u001B[33mLearn more: https://turborepo.dev/docs/reference/query#migrating-from-turbo-ignore\u001B[39m\n`
    );
  }

  info(
    `Using Turborepo to determine if this project is affected by the commit...\n`
  );

View on GitHub (pinned to f9245100cf)

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

Example fix

# before: Vercel Ignored Build Step
npx turbo-ignore

# after: set Ignored Build Step to 'Auto' (or leave empty) and let Vercel skip unaffected projects natively

Defensive patterns

Strategy: fallback

Validate before calling

# On Vercel, don't call turbo-ignore at all
if [ "$VERCEL" = "1" ]; then
  echo "using Vercel built-in skipping"
  exit 0
fi
turbo-ignore

Prevention

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

When it happens

Trigger: 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.

Common situations: Older Vercel monorepo setups that used turbo-ignore to skip unaffected app builds before built-in monorepo skipping existed.

Related errors

AI-assisted analysis of vercel/turborepo@f9245100cf (2026-08-17). Data as JSON: /api/errors/815a3d6bfb5a7f92. Report an issue: GitHub.

[33m"turbo-ignore" is deprecated. Use Vercel's built-in pro