# `smallforce app deploy`

Build, upload, publish, and activate an immutable Preview release

This page is generated from the same Commander definition shipped in SmallForce CLI 0.1.7. Run `smallforce app deploy --help` locally to view the same reference for your installed version.

## Complete command help

```text
Usage: smallforce app deploy [options]

Build, upload, publish, and activate an immutable Preview release

Options:
  --artifact <path>                  Existing ZIP; skips build and packaging
  --build-command <command>          Override smallforce.json build command
  --output <directory>               Override the configured output directory
  --name <name>                      Application name when adopting a project
  --slug <slug>                      Application slug when adopting a project
  --skip-build                       Package the existing output without rebuilding
  --timeout-seconds <seconds>        Terminal status timeout (default: "120")
  --poll-interval-ms <milliseconds>  Status poll interval (default: "500")
  --api-key <key>                    SmallForce API key, or set SMALLFORCE_API_KEY
  --backend-url <url>                SmallForce backend URL, or set SMALLFORCE_BACKEND_URL
  --json                             Print stable machine-readable JSON
  --text                             Print human-readable text
  --format <format>                  Output format: text or json
  -h, --help                         display help for command
```

## Related reference

- [`smallforce app`](/docs/cli/commands/app): Parent command and related operations.
- [CLI installation and authentication](/docs/cli/getting-started): Install the CLI and configure an API key.
- [CLI JSON output](/docs/cli/json-output): Use stable machine-readable output in scripts and agents.