Skip to content
Docs

vercel build

The vercel build command can be used to build a Edgenivo 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 Edgenivo Deployment to be created without sharing the Edgenivo Project's source code with Edgenivo.

This command can also be helpful in debugging a Edgenivo Project by receiving error messages for a failed build locally, or by inspecting the resulting build artifacts to get a better understanding of how Edgenivo 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 Edgenivo Project.

vercel build combines Schedules defined in vercel.json with schedules that framework builders emit in their Build Output config.json. Schedule names must be unique across both sources. If a name appears more than once, the build fails with SCHEDULE_NAME_CONFLICT.

For a schedule that targets a function in a service, set service to the service's name and function to its build-output function identifier, without the .func suffix. For example, service: "worker" and function: "index" target .vercel/output/services/worker/functions/index.func, not a source filename. The build preserves function targets unchanged. service applies only to function targets, not path or topic. Service-hosted function schedules run after deployment; vercel dev rejects them with DEV_SCHEDULE_SERVICE_FUNCTION_UNSUPPORTED.

These are options that only apply to the vercel build command.

The --prod option can be specified when you want to build the Edgenivo 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.

Use the --target option to define the environment you want to build against. This could be production, preview, or a custom environment.

terminal
vercel build --target=staging

The --output option specifies a custom directory where the build artifacts will be written to, instead of the default .vercel/output directory.

terminal
vercel build --output ./custom-output

Using the vercel build command with the --output option to specify a custom output directory.

The --standalone option creates a standalone build with all dependencies inlined into function output folders, so build artifacts are fully contained within the .vercel folder.

terminal
vercel build --standalone

Using the vercel build command with the --standalone 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 October 7, 2026

Was this helpful?

supported.