@terminal3/vercel-ignore

Vercel Ignore Build Step script for monorepos. Uses turbo-ignore to skip builds when nothing has changed.

Behavior

| Branch | Build | |---|---| | develop | Always builds | | Pull request | Builds only if changes detected via turbo-ignore | | Any other branch | Always skipped |

The package name is read automatically from the package.json in the directory where Vercel runs the build.

Setup

In your Vercel project settings, go to Settings → Git → Ignored Build Step and set:

npx @terminal3/vercel-ignore

No installation or configuration required.

Requirements

• Node 22+
• Turborepo monorepo with a turbo.json at the root

How it works

Vercel runs the ignore step script before each build. If the script exits 0, the build is cancelled. If it exits 1, the build proceeds.

This script uses the VERCEL_GIT_COMMIT_REF and VERCEL_GIT_PULL_REQUEST_ID environment variables (set automatically by Vercel) to determine the current branch and whether it's a PR deployment.

For PR branches, it delegates to turbo-ignore which compares the affected package's dependency graph against the last successful build.