Skip to content

fix: support Sevalla Node 24 builds

Viet Tan Tran requested to merge github/fork/ihsraham/fix/sevalla-node24-build into develop

Created by: ihsraham

Summary

  • Updates the production build scripts to call Next and the broken-link checker through node --import tsx directly.
  • Keeps support for the docs SEO packages that currently ship TypeScript source, while avoiding the Node 24 crash from the global NODE_OPTIONS='--import tsx/esm' hook.
  • Updates the Docs Quality Gates workflow to match Sevalla's pinned Node 22 runtime and npm install install path.

Root Cause

Sevalla was previously configured to use moving lts, which resolved to Node 24/npm 11. Under Node 24, the old global NODE_OPTIONS='--import tsx/esm' next build path crashes inside Next's config loader before the site build starts.

Sevalla staging and production are now pinned to Node 22, so the quality gate is pinned to Node 22 as well to keep CI aligned with deployment.

Validation

  • Config assertion: verified .github/workflows/quality-gates.yml uses node-version: '22' and npm install
  • Sevalla-style after Node 22 pin: Node 22.22.2/npm 10.9.7, npm install, npm run build
  • GHA-style after workflow update: Node 22.22.2/npm 10.9.7, npm install, npm run quality

Merge request reports