quant deploy
Deploy the contents of a build directory to QuantCDN. Pushes new and changed files, optionally unpublishes files removed locally, and purges cache for affected paths.
Synopsis
Section titled “Synopsis”quant deploy [dir] [options]If dir is omitted, quant deploy uses the directory configured by quant init (default build).
Description
Section titled “Description”deploy walks the build directory, compares each file’s MD5 against what’s already on the CDN, and uploads anything new or changed. After the upload completes it:
- Unpublishes any paths that exist on the CDN but no longer exist locally — unless
--skip-unpublishis set. - Purges the cache for affected paths — unless
--skip-purgeis set.
This makes quant deploy the standard command at the end of a CI build. For partial deployments of a single file, use quant file or quant page instead.
Arguments
Section titled “Arguments”| Name | Description |
|---|---|
dir |
Directory containing static assets. Defaults to the value from quant.json. |
Options
Section titled “Options”| Flag | Description | Default |
|---|---|---|
--skip-unpublish |
Don’t unpublish content removed locally. | false |
--skip-unpublish-regex |
Regex of paths to keep published even if removed locally. | — |
--skip-purge |
Don’t purge cache after deployment. | false |
--enable-index-html |
Keep index.html in URLs instead of normalising to /. |
false |
--chunk-size |
Number of files uploaded concurrently. | 10 |
--force |
Re-upload all files even if their hashes haven’t changed. | false |
Advanced options
Section titled “Advanced options”These flags exist for specific workflows and are hidden from --help:
| Flag | Description |
|---|---|
--revision-log <path> |
Track per-file MD5 hashes in a local log for faster incremental deploys without round-tripping to the API. |
--attachments |
Process attachments alongside the deploy. |
Examples
Section titled “Examples”Deploy the configured directory
Section titled “Deploy the configured directory”quant deployDeploy a specific directory
Section titled “Deploy a specific directory”quant deploy ./distFaster CI deploys with concurrency
Section titled “Faster CI deploys with concurrency”quant deploy --chunk-size 20Preserve manually managed paths
Section titled “Preserve manually managed paths”quant deploy --skip-unpublish-regex '^/legacy/.*'Force a full re-upload
Section titled “Force a full re-upload”quant deploy --forceSee also
Section titled “See also”quant scan— preview what would change without uploading.quant purge— manually purge cache.- CI/CD pipelines — full GitHub Actions example.