Skip to content

Stop Vercel from deploying the docs repo - #475

Closed
archandatta wants to merge 1 commit into
mainfrom
archand/disable-vercel-docs-deploys
Closed

Stop Vercel from deploying the docs repo#475
archandatta wants to merge 1 commit into
mainfrom
archand/disable-vercel-docs-deploys

Conversation

@archandatta

Copy link
Copy Markdown
Contributor

Summary

The Vercel check has been red on every docs PR and on main for as long as the status history goes back. It is not a broken change — it is a misconfigured project.

From the build log:

Your application is being built using `next build`.
Installing dependencies... up to date in 415ms
Warning: Could not identify Next.js version, ensure it is defined as a project dependency.
Error: No Next.js version detected.

This repo has no package.json at all, and the Vercel project's framework preset is Next.js. There is nothing here for next build to build and never was. Docs are deployed by Mintlify, which is the check that actually tells you whether a change went live.

vercel.json with git.deploymentEnabled: false makes the Git integration skip this repo, so no deployment is attempted and no check is posted.

Why bother

A check that is always red is a check nobody reads. #471, #469 and #468 all merged with it failing. Removing it means the next genuinely-red check on a docs PR means something.

Alternative

Disconnecting the project in the Vercel dashboard does the same thing. This lives in the repo instead, where it is visible and revertible in review — pick whichever you prefer. If Kernel does intend to build this repo on Vercel eventually, the fix is a package.json plus the right framework preset, not this file.

The Vercel project for this repo is configured as a Next.js app, and this repo
has no package.json at all, so every deployment fails at "No Next.js version
detected" — on main and on every pull request. Docs are deployed by Mintlify,
which is the check that actually reports whether a change is live.

Turning deployments off at the repo level removes a permanently red check that
every contributor has learned to ignore. The alternative is disconnecting the
project in the Vercel dashboard, which does the same thing but isn't visible
here.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@mintlify

mintlify Bot commented Aug 4, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
Kernel 🟢 Ready View Preview Aug 4, 2026, 2:22 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

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