@vercel/build-utils
15.5.0 · 18 Nov 2026Apache-2.07.9M / weekRepositoryHomepagenpmAtom feed
13.36.3 is the newest release of 13.x.
In short
7 breaking5 removed4 deprecated58 new71 fixed10 changed
- Breaking
Remove getSpawnOptions
- Breaking
Drop Node.js 18, bump minimum to Node.js 20
- Breaking
Add support for vlt as a package manager
- Breaking
Detect v9 pnpm lockfiles as pnpm 10 generated
- Breaking
Change getPathOverrideForPackageManager() to use detectedLockfile argument
- Breaking
Remove legacy
avoidTopLevelInstalllogic - Breaking
Drop Node.js 14, bump minimum to Node.js 16
- Removed
Remove env var check for node24
Release note
The section about @vercel/build-utils of a note shared by several packages.
@vercel/build-utils
Patch Changes
Add 'go' as a valid runtimeLanguage option for Lambda functions
Patch Changes
Replace getRuntimeNodeVersion with getNodeVersion
Patch Changes
Remove getSpawnOptions
Patch Changes
Replace getNodeVersion with getRuntimeNodeVersion
Add zero-config support for Koa.js
Patch Changes
Update http links in Node.js version incompatibility message to https
Ensure internal build step runs if a build script is missing
Patch Changes
Adding in user configured deploymentId to build output type
Skip secondary installation for vercel.ts
Patch Changes
Only create api builders for
.pyfiles that export an app or handler
Patch Changes
Use
workspace:*for workspace dependencies
Patch Changes
Bump NFT dependency
Patch Changes
Disables auto instrumentation when the app has manual instrumentation setup
Minor Changes
- Removed
Remove env var check for node24
Patch Changes
Support
runtimeLanguagein build-utils
Patch Changes
Only run introspection when isExperimentalBackendsWithoutIntrospectionEnabled is truthy
Minor Changes
- Removed
Remove --unsafe-perm from npm install command
Patch Changes
Improve warning messages surrounding Elysia
Patch Changes
Revert "Remove getSpawnOptions"
Major Changes
- Breaking
Remove getSpawnOptions
Patch Changes
Add helper for detecting backend builders
Patch Changes
Add Elysia framework
Patch Changes
Allow Node.js 24 behind env var feature flag
Patch Changes
Add backend util helpers
Minor Changes
Add support for Bun through a vercel.json property
Patch Changes
Revert the prebuilt archive split from 20MB back to 100MB
Patch Changes
Reuse duplicated node builder logic
Patch Changes
Change archive split from 100MB -> 20MB
Minor Changes
Support turbo.jsonc
Major Changes
- Breaking
Drop Node.js 18, bump minimum to Node.js 20
Patch Changes
Add support for the supportsCancellation function flag
Patch Changes
Fix 404 status for /api routes when using Hono with the vercel dev server
Major Changes
- Breaking
Add support for vlt as a package manager
Patch Changes
Reverting support for
preferredRegion
Patch Changes
- Deprecated
Deprecate Node.js 18.x with warning
Patch Changes
Rename experimental maxAttempts to maxDeliveries
Patch Changes
Simplify experimental triggers
Patch Changes
Make POST method required
Update more handling for experimentalTriggers
Patch Changes
Add CloudEventTrigger support for Lambda functions
Patch Changes
Next package uses @vercel/routing-utils HasField rather than redefining & stricter validation.
Make architecture a defined property on Lambda classes to apply when creating
Expose VERCEL_PROJECT_ID as NEXT_PUBLIC_VERCEL_PROJECT_ID
Minor Changes
Provide a more verbose error when package.json is not valid
Allow configuring functions
architecturevia thevercel.jsonconfiguration
Patch Changes
Display warning when yarn dynamic require error may happen
Increase max memory limit
Minor Changes
Disable yarn global cache before installs so build cache caches deps
Minor Changes
Expose pnpm6 within the detected package manager path for future versions of the build container
Patch Changes
Add support for expire values in Next.js prerender manifest
Detect yarn version from lockfile version
Patch Changes
Parse yarn.lock file version
Expose VERCEL_DEPLOYMENT_ID as NEXT_PUBLIC_VERCEL_DEPLOYMENT_ID
Fix vitest-e2e glob to include integration.test.ts
Minor Changes
Delay pnpm@10 preferred date
Patch Changes
Type-check tests
Minor Changes
Detect v9 pnpm lock files as pnpm 10 for new projects
Patch Changes
Improve build log messages surrounding pnpm 10
Extract checkIfAlreadyInstalled helper to clarify intent
Allow pnpm 10 to use package.json#packageManager without an engines error
Minor Changes
Add
VERCEL_TARGET_ENVto prefixed env vars
Patch Changes
Move
runNpmInstallSemacloser to where it's usedExtract getInstallCommandForPackageManager to module scope
Remove redundant sema release
Revert support pnpm 10
Major Changes
- Breaking
Detect v9 pnpm lockfiles as pnpm 10 generated
Patch Changes
Extract install command specific logic into helper
Remove dead node 16 check
Minor Changes
Support process tracing
Patch Changes
Add tracer utility to @vercel/build-utils
Minor Changes
Add .yarn/cache to build cache
Patch Changes
Shift node 16 deprecation date to 2025-02-03
Minor Changes
Add
useWebApiproperty toNodejsLambdaclassConvert NodeVersion to class and add state getter
[ruby] convert RubyVersion to class and add state getter
Patch Changes
Revert build utils refactor
Major Changes
- Breaking
Change getPathOverrideForPackageManager() to use detectedLockfile argument
Patch Changes
Refactor build-util usage to reuse detected lockfile
Add support for
images.qualities
Minor Changes
Add bun detection using bun.lock
Minor Changes
Support splitting archive deployments in parts.
Minor Changes
Add support for
NOW_EPHEMERAL_FILES_S3_URL,NOW_FILES_CLOUDFRONT_URLandNOW_FILES_S3_URLenvironment variables
Minor Changes
- Removed
Remove
VERCEL_ALLOW_NODEJS22env var check
Patch Changes
Support allowHeader from Next.js for filtering request headers during revalidation
Patch Changes
Improve parsing of
turbo.jsonFix corepack
packageManagerdetection on monorepos
Patch Changes
Parse
turbo.jsonas json5
Patch Changes
Fix special version specifier handling for
turbo
Patch Changes
Revert "[build-utils] Fix corepack
packageManagerdetection on monorepos"
Patch Changes
Disable corepack when Turborepo does not support
COREPACK_HOMEFix corepack
packageManagerdetection on monorepos
Patch Changes
Add support for
images.localPatterns
Patch Changes
Add types for
images.remotePatterns.searchto vercel.json
Patch Changes
Allow Node.js v22 behind env var feature flag
Patch Changes
Introduce new chain configuration types for Partial Prerendering
Patch Changes
Revert "Revert "Revert "Fix corepack
packageManagerdetection on monorepos"""
Patch Changes
Revert "Revert "Fix corepack
packageManagerdetection on monorepos""
Minor Changes
Change warnings to errors in invalid corepack package manager states
Patch Changes
Provide help when users get ERR_PNPM_UNSUPPORTED_ENGINE errors without corepack
Fix package-manager-warning-1 to happen only happen in correct cases
Patch Changes
Limit
package.json#packageManagerparsing to concrete versionsCatch PNPM_UNSUPPORTED_ENGINE when corepack is enabled and throw a more helpful error
Patch Changes
Revert "Revert "warn on mismatched corepack and detected package managers""
Patch Changes
Remove implicit reliance on
@types/globfor downstream consumers
Patch Changes
Revert "warn on mismatched corepack and detected package managers"
Patch Changes
Revert "Fix corepack
packageManagerdetection on monorepos"
Patch Changes
Fix corepack
packageManagerdetection on monorepos
Patch Changes
Reject mismatched corepack and detected package managers
Patch Changes
Add build callback handling
Minor Changes
Adds the ability for builders to define a
diagnosticsstep that is called after the build operation is done.
Implements the diagnostics step in thenextbuilder.
Patch Changes
Add resolved node version range to warning message
Patch Changes
Change node 16.x EOL for Vercel
Improve error message and refactor
Handle case of not having lockfile when corepack is enabled
Patch Changes
Update node@16 deprecation day
Minor Changes
Fix corepack detection for package manager version determination
Patch Changes
Fix triggering of ignored project settings node version warning
Patch Changes
Log more around package manager detection
Patch Changes
Add log to package manager version detection
Patch Changes
Pnpm lockfile testing and fixing
Minor Changes
Update pnpm version detection logic
Add support for pnpm 9
Major Changes
- Breaking
Remove legacy
avoidTopLevelInstalllogic
Patch Changes
Add
VERCEL_PROJECT_PRODUCTION_URLframework env var prefix
Minor Changes
Trigger release
Minor Changes
Add
getOsRelease()andgetProvidedRuntime()functions
Minor Changes
Allow environment variables to be specified for
EdgeFunction
Patch Changes
Export
getSupportedNodeVersion
Minor Changes
Add
baseparameter toscanParentDirs()
Minor Changes
- Removed
Remove
VERCEL_ENABLE_NPM_DEFAULTenv var check
Patch Changes
Rename variants to flags and remove legacy flags
Patch Changes
Increase max memory limit
Minor Changes
Revert "Revert "Default ruby to only currently supported version (3.2.0)""
Minor Changes
Revert "Default ruby to only currently supported version (3.2.0)"
- Deprecated
Mark
flagsas deprecated and replace them withvariants Change default package manager when no lockfile detected from
yarntonpm(gated behind feature flag)
Patch Changes
Update internal type for variants
Patch Changes
Add experimental field to Lambda and size to FileFsRef output
Minor Changes
- Deprecated
Deprecate
EdgeFunction#nameproperty
Patch Changes
Extend Node v16 discontinue date to 2024-06-15
Minor Changes
Adds new helper
getPathForPackageManager()
Minor Changes
Add
--deprecatedoption tovc project lscommand
Patch Changes
- Removed
Remove Node.js v20 env var check
Patch Changes
Select Node.js version based on what's available in build-container
Patch Changes
Add experimental flag to allow Node.js v20
Patch Changes
Update bun detection and add tests for projects with both bunlock binary and yarn.lock text files
Patch Changes
Internal variants
Minor Changes
Add new optional prerender field: experimentalStreamingLambdaPath
Add zero config detection for bun package manager
Patch Changes
Add
experimentalBypassForfield to Prerender
Patch Changes
Add descriptions to NodeVersion properties
Updated semver dependency
Minor Changes
Support serverless function architecture
Major Changes
- Breaking
Drop Node.js 14, bump minimum to Node.js 16
Patch Changes
Fix
getPrefixedEnvVars()to handleVERCEL_BRANCH_URL
Patch Changes
Push back
nodejs16.xdiscontinue date to2024-02-06
Patch Changes
Revert "[build-utils] Allow file-ref sema to be controlled through env flag"
Minor Changes
Add
getNodeBinPaths()andtraverseUpDirectories()functions
Patch Changes
Publish missing build-utils
Patch Changes
Remove usage of
envfrom Edge Functions and Middleware
Patch Changes
- Deprecated
Deprecate Node.js 14.x and 16.x with warning
A whole project to check? Paste its package.json in the dependency check: every deprecated, outdated or vulnerable dependency, with what to upgrade to. Free, no account.