vercel/turborepo · warning

Learn more: https://turborepo.dev/docs/reference/query#

Error message

Learn more: https://turborepo.dev/docs/reference/query#migrating-from-turbo-ignore

What it means

Companion line to the non-Vercel turbo-ignore deprecation warning: prints the migration guide URL for moving to `turbo query affected`. Informational only, emitted with hardcoded yellow ANSI escapes and a trailing newline.

Source

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

  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);
    if (existsSync(directory)) {
      inputs.directory = directory;
    } else {
      warn(
        `Directory "${opts.directory}" does not exist, using current directory`
      );
      inputs.directory = process.cwd();

View on GitHub (pinned to f9245100cf)

Solutions

  1. Follow the guide and replace turbo-ignore with `turbo query affected`
  2. Remove turbo-ignore steps once migrated
Defensive patterns

Strategy: fallback

Validate before calling

# Non-Vercel CI: branch on the query output instead of the deprecated tool
turbo query affected --exit-code --output=json > affected.json || [ $? -eq 1 ] || exit 2

Prevention

When it happens

Trigger: turbo-ignore running outside Vercel (no VERCEL=1), i.e. in plain CI pipelines.

Common situations: CI maintainers following the printed link to migrate their pipelines off turbo-ignore.

Related errors


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