What's happening
The preview job (Docs preview workflow, .github/workflows/docs-preview.yml) fails on every recent PR with:
Error: Invalid request: `files` should NOT have more than 15000 items, received 16305.
Try using `--archive=tgz` to limit the amount of files you upload.
The count climbs as the site grows (16,270 → 16,305 across the last couple of runs).
Evidence it's repo-wide, not PR-specific
So the deployed file set recently crossed Vercel's hard 15,000-file upload cap. It's independent of any individual PR's content — template-content PRs add a handful of files, nowhere near the cap.
Impact
preview is red on every new PR. It is not a required check (the main branch is unprotected), so it does not block merges — but it's persistent red noise and would mask a genuine preview regression.
Root cause
The Vercel deploy step uploads the full relationalai-docs checkout as loose files — the external docs site plus npm install node_modules plus the synced templates — which together exceed the 15k-file cap. The deploy goes through aldenquimby/deploy-to-vercel-action@v2.
Suggested fixes (for the owners to evaluate)
--archive=tgz on the Vercel deploy (Vercel's own suggestion) — but confirm aldenquimby/deploy-to-vercel-action@v2 forwards extra CLI args; if not, switch that step to a raw vercel deploy --archive=tgz …..vercelignore / build-output deploy in the relationalai-docs repo so node_modules and build artifacts aren't uploaded as loose files.
cc @somacdivad @jablonskidev — flagging as the docs-preview pipeline owners; happy to open a PR for option 1 if you'd like, but it touches shared CI and can't be validated without the Vercel secrets.
What's happening
The
previewjob (Docs preview workflow,.github/workflows/docs-preview.yml) fails on every recent PR with:The count climbs as the site grows (16,270 → 16,305 across the last couple of runs).
Evidence it's repo-wide, not PR-specific
preview).So the deployed file set recently crossed Vercel's hard 15,000-file upload cap. It's independent of any individual PR's content — template-content PRs add a handful of files, nowhere near the cap.
Impact
previewis red on every new PR. It is not a required check (themainbranch is unprotected), so it does not block merges — but it's persistent red noise and would mask a genuine preview regression.Root cause
The Vercel deploy step uploads the full
relationalai-docscheckout as loose files — the external docs site plusnpm installnode_modulesplus the synced templates — which together exceed the 15k-file cap. The deploy goes throughaldenquimby/deploy-to-vercel-action@v2.Suggested fixes (for the owners to evaluate)
--archive=tgzon the Vercel deploy (Vercel's own suggestion) — but confirmaldenquimby/deploy-to-vercel-action@v2forwards extra CLI args; if not, switch that step to a rawvercel deploy --archive=tgz …..vercelignore/ build-output deploy in therelationalai-docsrepo sonode_modulesand build artifacts aren't uploaded as loose files.cc @somacdivad @jablonskidev — flagging as the docs-preview pipeline owners; happy to open a PR for option 1 if you'd like, but it touches shared CI and can't be validated without the Vercel secrets.