
turbo query affectedVercel's ignoreCommand (in apps/website/vercel.json) asks turbo query affected whether a commit can change the
website, and skips the deploy when it cannot. It replaced Vercel's default ignore step, git diff HEAD^ HEAD --quiet,
which has no path scope and so answers "changed" for every commit: one Dependabot batch produced 20 deployments in ten
minutes that way.
The decision is made by turbo's dependency graph, not by paths: a matrix-design-system change counts as a website
change, while a matrix-rain-showcase or .github change does not (those reach GitHub Pages through pages.yml).
Turbo prunes the root lockfile per package, so a bump that only moves a matrix-rain-showcase dependency does not mark
the website affected even though package-lock.json changed. That is what makes this work for Dependabot, and it was
measured: 101c5f67 (rain-showcase dependency and lockfile) skips, 5a8ccff6 (design-system dependency and lockfile)
builds. --exit-code maps onto Vercel's contract directly: 0 when nothing is affected (skip), 1 when something is
(build). Nothing is lost by skipping: the next website commit builds the full tree, and scheduled-rebuild.yml
redeploys every Monday regardless.
npx turbo-ignore website --fallback=HEAD^1: the predecessor. Identical verdicts on both test commits, but it is
deprecated in favour of turbo query affected, prints a deprecation warning into every build log, and costs a second
registry fetch because it shells out to npx -y turbo@... --dry=json. Worse, on an unreachable base it silently falls
back to its --fallback ref and can wrongly skip, where turbo query affected exits 1 and builds. That matters
because every skip leaves VERCEL_GIT_PREVIOUS_SHA further back, drifting out of Vercel's clone depth precisely as
skipping succeeds. It still ships with every turbo release, so it remains a working fallback.--base is VERCEL_GIT_PREVIOUS_SHA when set, else the branch's merge-base with main. The variable holds the last
successful deployment and is empty on any branch with no previous deployment (every Dependabot PR, and the first push
of any feature branch); an empty --base makes turbo query affected exit 2. The fallback was first HEAD^1, on the
assumption that such branches are always one commit off main. That holds for Dependabot but not for a feature
branch pushed with many commits: a last commit touching only .claude/ looked unaffected against HEAD^1, and the
preview of a 40-commit branch was skipped. The logic now lives in apps/website/scripts/vercel-ignore-build.sh,
which fetches main with git fetch --depth=50 and uses git merge-base HEAD FETCH_HEAD, so exactly the branch's
own commits are compared. It fetches by URL, built from VERCEL_GIT_REPO_OWNER and VERCEL_GIT_REPO_SLUG, because
Vercel's clone has no origin remote (the first version fetched origin and so built every time); the repository is
public, so no credentials are needed. main's tip was tried and rejected: it also counts main's newer commits, so nearly every
Dependabot branch would build, and on a shallow clone turbo cannot relate a depth-1 FETCH_HEAD to HEAD at all
(GitRefNotFound, which builds every time). Measured on a depth-10 clone: a .github-only branch five commits behind
main skips, a branch with an earlier website commit and a .claude/-only last commit builds, and a branch whose
fork point is older than the clone has no merge-base and builds. A failed fetch or a missing merge-base exits 1
(build), never the reverse.--head is never passed: --base=<sha>^ --head=<sha> reports the website affected for a rain-showcase-only commit,
where --base=<sha>^ alone correctly reports it unaffected.turbo is pinned to a major (turbo@^2): the ignore step runs before npm install, so npx fetches turbo from the
registry, and an unpinned turbo 3 could change the change-detection semantics mid-deploy.