[waleedlatif1]

Summary

• Add apps/docs/vercel.json with an Ignored Build Step (scripts/vercel-ignore-build.sh)
• Production and staging build every affected commit, as today, so a shared-package change that breaks the docs build still fails on staging before it reaches main
• Other preview branches build only when apps/docs changed since the branch's last successful deployment (VERCEL_GIT_PREVIOUS_SHA); "skip unaffected projects" already triggers docs previews on every @sim/db, @sim/emcn, @sim/utils or lockfile change, which is nearly every app PR
• Anything the script can't decide builds: a branch's first deployment, or a previous SHA outside Vercel's shallow clone

Type of Change

• Improvement

Testing

• Ran the script against real commits for each path: production → build, staging → build, first deployment → build, unknown previous SHA → build, docs changed → build, no docs change → skip (exit 0 with a log line)
• shellcheck and bash -n clean; biome check on vercel.json
• Behavior follows Vercel's documented ignoreCommand contract (runs in the root directory before install; exit 0 skips, 1 builds)

Checklist

• Code follows project style guidelines
• Self-reviewed my changes
• Tests added/updated and passing (new tests pass the test-audit authoring gate)
• No new warnings introduced
• I confirm that I have read and agree to the terms outlined in the Contributor License Agreement (CLA)

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
docs	Ready	Preview	Oct 24, 2026 6:52pm UTC

[cubic-dev-ai]

No issues found across 2 files

Confidence score: 5/5

• Automated review surfaced no issues in the provided summaries.
• No files require special attention.

<sub>Heads up: you’ve reached your flex budget. Increase your flex budget or wait for usage to reset.

Turn on auto-fix | Re-trigger cubic</sub>

[greptile-apps]

Confidence Score: 5/5

[Low impact] The PR appears safe to merge.

Summary

Adds a Vercel build gate for docs previews.

• Feature-branch docs previews skip builds when docs stay unchanged.

Diagram

%%{init: {'theme': 'neutral'}}%%
flowchart TD
  A[Docs deployment] --> B{Production or staging?}
  B -->|Yes| C[Build]
  B -->|No| D{Previous commit available?}
  D -->|No| C
  D -->|Yes| E{Docs comparison}
  E -->|Changed or failed| C
  E -->|Unchanged| F[Skip preview build]

Loading

_{Reviews (1) · Last reviewed commit: "improvement(docs): build feature-branch ..." · Reviewed by Greptile}