voxal build

voxal build bundles and validates your app into a single file on disk. It is fully offline: no login and no network. Use it for CI, for inspecting the artifact, or before a deploy.

voxal build [dir] [--out <file>]

dir defaults to the current directory. The entry comes from voxal.json (the main field, default app.js).

What it does

1. Reads voxal.json for the entry file.
2. Runs the bundle pipeline with production settings.
3. Boot-validates the bundle to confirm it loads and starts.
4. Enforces the same size limits as deploy.
5. Writes the artifact and prints its path and checksum.

The output path is --out <file>, or <dir>/dist/<name>.js by default.

voxal build
  bundled myapp -> dist/myapp.js
    size   18.4 KiB
    sha256 9f2c1a...e7

Then run voxal deploy to ship it.

Flags

The bundle pipeline

Both build and deploy use the same pipeline. Your entry file, the SDK, and any pure-JS dependencies are bundled into one file.

• JSX is enabled in .js too, so app.js can contain JSX.
• TypeScript is transpiled (types are stripped, never type-checked).
• Production builds are minified, with process.env.NODE_ENV set to "production" so React builds in production mode.

The bundle is then boot-validated to confirm it loads and starts your app before it can be deployed.

Size limits

Size is measured as the UTF-8 byte length of the bundle. See Limits for the full picture.