vercel build
Learn how to build a Vercel Project locally or in your own CI environment using the vercel build CLI command.The vercel build
command can be used to build a Vercel Project locally or in your own CI environment.
Build artifacts are placed into the .vercel/output
directory according to the
Build Output API.
When used in conjunction with the vercel deploy --prebuilt
command, this allows a Vercel Deployment
to be created without sharing the Vercel Project's source code with Vercel.
This command can also be helpful in debugging a Vercel Project by receiving error messages for a failed build locally, or by inspecting the resulting build artifacts to get a better understanding of how Vercel will create the Deployment.
It is recommended to run the vercel pull
command before invoking vercel build
to ensure that
you have the most recent Project Settings and Environment Variables stored locally.
vercel build
These are options that only apply to the vercel build
command.
The --prod
option can be specified when you want to build the Vercel Project using Production Environment Variables. By default, the Preview Environment Variables will be used.
vercel build --prod
The --yes
option can be used to bypass the confirmation prompt and automatically pull environment variables and Project Settings if not found locally.
vercel build --yes
The following global options can be passed when using the vercel build
command:
For more information on global options and their usage, refer to the options section.
Was this helpful?