vercel build

Learn how to build a Vercel Project locally or in your own CI environment using the vercel build CLI command.
Table of Contents

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.

terminal
vercel build

Using the vercel build command to build a Vercel Project.

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.

terminal
vercel build --prod

Using the vercel build command with the --prod option.

The --yes option can be used to bypass the confirmation prompt and automatically pull environment variables and Project Settings if not found locally.

terminal
vercel build --yes

Using the vercel build command with the --yes option.

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.

Last updated on July 17, 2024