vercel/turborepo · warning

Learn more: https://vercel.com/docs/monorepos#skipping-

Error message

Learn more: https://vercel.com/docs/monorepos#skipping-unaffected-projects

What it means

Companion line to the Vercel turbo-ignore deprecation warning: prints the documentation URL for Vercel's built-in skipping of unaffected projects. Purely informational; emitted with hardcoded yellow ANSI escapes and a trailing newline as part of the deprecated-command notice.

Source

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

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`
  );

  // set default directory
  if (opts.directory) {
    const directory = path.resolve(opts.directory);

View on GitHub (pinned to f9245100cf)

Solutions

  1. Follow the link and migrate to Vercel's built-in project skipping
  2. Remove turbo-ignore from the Vercel build configuration
Defensive patterns

Strategy: fallback

Validate before calling

# Gate on the Vercel env before invoking the deprecated command
[ "$VERCEL" != "1" ] || exit 0   # rely on built-in skipping on Vercel
turbo-ignore

Prevention

When it happens

Trigger: Same condition as the main deprecation warning: turbo-ignore invoked with VERCEL=1 in the environment (Vercel build step).

Common situations: Vercel builds where the operator needs the migration reference link shown in build logs.

Related errors


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