Skip to main content

arc build

Run the project's build.

Usage​

arc build [options]

Options:
-j, --json Format output as JSON [boolean] [default: false]
-q, --quiet Output only errors [boolean] [default: false]
-C, --cwd Set the working directory [string] [default: "."]
-h, --help Show help [boolean]
-v, --version Show version number [boolean]

Description​

Runs the project's workflow.build command from the project root, after validating the project.

arc build

When the build succeeds, it prints the path of deploy_dir, or, if the build didn't create it, warns Build didn't create deploy_dir (<dir>). (deploy_dir_not_built). When no build command is configured, nothing runs, and it prints Nothing to do.

You don't need to run this yourself: arc deploy and arc serve run it, and so does the GitHub release workflow.

Output​

It prints Built. with the build's output folder, or Nothing to do. when there's no build command. If the build doesn't create deploy_dir, the heading turns yellow and it warns. With --json:

{ "artifact": { "path": "/home/you/star-drift/.arcadible-public" }, "warnings": [] }

artifact is { "missing": "…" } when deploy_dir wasn't created, with a deploy_dir_not_built warning, and null when there's no build command. warnings lists those and arc validate's.

CodeWhen
0The build ran, or there was nothing to do
1The project has issues or its files can't be read, or the build failed or was stopped