Skip to content

fix(docs): bypass Stack build on Vercel - #257

Merged
olliethedev merged 2 commits into
mainfrom
fix/docs-vercel-cold-build
Sep 1, 2026
Merged

fix(docs): bypass Stack build on Vercel#257
olliethedev merged 2 commits into
mainfrom
fix/docs-vercel-cold-build

Conversation

@olliethedev

Copy link
Copy Markdown
Collaborator

Summary

  • run the docs app's Next.js build directly on Vercel
  • bypass Turbo's ^build edge to the full @btst/stack bundle
  • expose a docs-specific build:vercel script so the deployment seam is explicit

Why

The v3.0.0 production docs deployment failed with BUILD_EXCEEDED_MAXIMUM_TIME. Vercel invalidated its Node 22 cache after the project moved to Node 24, then turbo run build cold-built @btst/stack and never reached the docs' next build before the 45-minute limit.

The Rollup use client and mixed-export messages were warnings, not the failure.

Verification

  • clean frozen install with packages/stack/dist absent
  • pnpm --dir docs build under Node 22: passed, 56 pages
  • pnpm --dir docs build:vercel under Node 24: passed, 56 pages
  • standards review: 0 findings
  • specification review: 0 findings

Vercel created preview deployments for both branch commits but canceled them at the project-level Ignored Build Step before producing any build logs. Production Git deployments are the remaining remote verification path.

@vercel

vercel Bot commented Sep 1, 2026

Copy link
Copy Markdown

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

2 Skipped Deployments
Project Deployment Actions Updated
better-stack-docs Ignored Ignored Sep 1, 2026 1:54pm UTC
better-stack-playground Ignored Ignored Sep 1, 2026 1:54pm UTC

Request Review

@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Sep 1, 2026

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review Completed 2026-09-01T13:57:28.525511Z 59b5ad3 PR opened
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@olliethedev
olliethedev merged commit 918ed16 into main Sep 1, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant