@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
2 new1 fixed
Release note
Minor Changes
Add
servicesas the canonical multi-service project configuration and keepexperimentalServicesV2as a deprecated backwards-compatible alias.
Patch Changes
Add an experimental container service runtime. A service with
runtime: "container"either builds itsDockerfile/Containerfileand pushes
the resulting OCI image to the Vercel Container Registry (VCR), or passes a
prebuilt image reference through as build output.@vercel/container(new builder): authenticates to VCR with the project'sVERCEL_OIDC_TOKEN, ensures the repository exists, builds and pushes the
image, and emits a digest-pinned reference inhandler(container functions
aretype: "Lambda"withruntime: "container"; the platform surfaceshandleras the image downstream). Usesdockeron developer machines andbuildah(daemonless) in the Vercel build container behind a sharedContainerEngineinterface. Supportsvc devviastartDevServer(local
build/run, env parity, log forwarding) andprepareCachefor buildah layer
reuse between builds. Build flow is instrumented with tracing spans
(non-secret diagnostics) and debug logging gated onBUILDER_DEBUG.@vercel/build-utils: add theContainerImagebuild-output type.@vercel/fs-detectors: resolve container services fromvercel.json
(theservicesconfig and its deprecatedexperimentalServices/experimentalServicesV2aliases). ADockerfile,Containerfile, or*.dockerfileentrypoint triggers a build; any other entrypoint is treated as
a prebuilt OCI image reference.vercel: wire container output intovercel buildresult writing and
config validation.
Buildah specifics in the build container: host networking for
RUNsteps,
nativeoverlaystorage on the XFS/vercelvolume (deferring to the image'sstorage.conf), zstd push compression, and registry credentials read from the
provisioned auth file when present. Several knobs are available for debugging:VERCEL_CONTAINER_ENGINE,VERCEL_VCR_STRICT_STORAGE,VERCEL_VCR_DISABLE_LAYER_CACHE, andVERCEL_VCR_FORCE_LOGIN.Set the Node.js 20 discontinuation date to October 1, 2026.
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.