Skip to content

chore(website): target Node.js 24, add vercel.json +semver: none - #256

Merged
bravo-kernel merged 2 commits into
mainfrom
chore/node-24-vercel
Aug 16, 2026
Merged

chore(website): target Node.js 24, add vercel.json +semver: none#256
bravo-kernel merged 2 commits into
mainfrom
chore/node-24-vercel

Conversation

@bravo-kernel

Copy link
Copy Markdown
Contributor

Bumps the website toolchain to Node.js 24 and pins it where Vercel actually reads it.

Node.js 24

File Change
website/.nvmrc 2024 (local dev parity)
website/package.json added "engines": { "node": "24.x" }

engines.node is the part that matters for the deployment: Vercel reads the Node version from Project Settings, overridden by engines.node in package.json. It does not read .nvmrc. Per the current docs, 24.x is now Vercel's default (20.x and 22.x are the other options), so this aligns with the platform default rather than fighting it.

vercel.json

New website/vercel.json, documenting the build in-repo:

{
  "$schema": "https://openapi.vercel.sh/vercel.json",
  "buildCommand": "yarn build",
  "outputDirectory": "build"
}

Both values match what Vercel already does by auto-detection, so this is a no-op that just makes the settings reviewable. framework is deliberately omitted — the exact Docusaurus slug isn't in the docs and auto-detection already handles it. Note there is no Node version property in vercel.json; that is why the pin lives in package.json.

One thing to confirm on the preview deploy: this only takes effect if the Vercel project's Root Directory is website (near-certain, since there is no root package.json).

Dependency bumps: none needed

@docusaurus/* is already at 3.10.2, which is the latest release. yarn outdated only flagged react/react-dom 19.2.0 → 19.2.8, already inside the existing ^19.2.0 range — left to dependabot.

The second commit refreshes caniuse-lite via npx update-browserslist-db@latest, collapsing four stale lockfile entries into 1.0.30001809. It reported No target browser changes, and package.json is untouched.

Verification

  • yarn build succeeds on Node v24.15.0
  • after the lockfile refresh the build emits zero warnings (the caniuse-lite is 21 months old and baseline-browser-mapping notices are gone)
  • yarn install --frozen-lockfile — what Vercel runs — reports Already up-to-date, so the lockfile and manifest are consistent

CI does not build the website, so the Vercel preview deploy on this PR is the real check.

🤖 Generated with Claude Code

bravo-kernel and others added 2 commits August 16, 2026 11:49
- .nvmrc 20 -> 24
- package.json engines.node "24.x", which is what Vercel reads to pin the
  build image Node version (vercel.json has no node version property)
- vercel.json documents the build command and output directory in-repo

Verified: `yarn build` succeeds on Node v24.15.0. Dependencies are already
at their latest versions (Docusaurus 3.10.2), so no bumps were needed.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
…er: none

Collapses four stale caniuse-lite lockfile entries into 1.0.30001809,
silencing the "browsers data is 21 months old" build warnings. No target
browser changes and package.json is untouched.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@vercel

vercel Bot commented Aug 16, 2026

Copy link
Copy Markdown

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

Project Deployment Actions Updated (UTC)
docusaurus-powershell Ready Ready Preview Aug 16, 2026 9:55am

@bravo-kernel
bravo-kernel merged commit 3d3da4f into main Aug 16, 2026
11 checks passed
@bravo-kernel
bravo-kernel deleted the chore/node-24-vercel branch August 16, 2026 09:59
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