Get started with the Quant CLI

The Quant CLI is a command-line tool for deploying static sites and managing content on QuantCDN.

Requirements

Install the CLI globally via npm:

npm install -g @quantcdn/quant-cli

Verify the installation:

quant --version

Navigate to a directory containing your build output and run:

quant init

You’ll be prompted for:

QuantCDN endpoint: Use the default https://api.quantcdn.io
Client ID: Your organisation ID (from your dashboard URL)
Project: The project machine name
Token: Your project API token (from Integrations section)
Directory: The folder containing your static assets (e.g., dist, build, public)

This creates a quant.json configuration file in the current directory.

For CI/CD environments, pass all values as flags:

quant init \
  -c "$QUANT_CUSTOMER" \
  -t "$QUANT_TOKEN" \
  --project="$QUANT_PROJECT" \
  -e "https://api.quantcdn.io" \
  -d ./dist

Deploy all content from your configured directory:

quant deploy

This pushes all files that have changed since the previous deployment. By default, content removed locally will be unpublished from the CDN.

Option	Description
`--revision-log <path>`	Track MD5 hashes locally for faster incremental deploys
`--skip-unpublish`	Don’t unpublish removed content
`--skip-unpublish-regex <pattern>`	Skip unpublish for paths matching pattern
`--skip-purge`	Skip automatic cache purge
`--chunk-size <n>`	Concurrent uploads (default 10, max 20)
`--force`	Push all assets even if hashes match
`--enable-index-html`	Include `index.html` in URLs
`--attachments`	Process attachments

quant deploy --revision-log .quant-revision --skip-purge

Command	Description
`quant init`	Initialise project configuration
`quant info`	Display current project configuration

Command	Description
`quant deploy [dir]`	Deploy static site output
`quant file <file> <location>`	Deploy a single asset
`quant page <file> <location>`	Deploy a single HTML page
`quant publish <path>`	Publish an asset (make live)
`quant unpublish <path>`	Unpublish an asset (remove from CDN)
`quant delete <path>`	Permanently delete a deployed path

Command	Description
`quant purge <path>`	Purge CDN cache for a URL pattern

Command	Description
`quant redirect <from> <to> [status]`	Create a redirect rule

Command	Description
`quant function <file> <description>`	Deploy an edge function
`quant filter <file> <description>`	Deploy a content filter function
`quant auth <file> <description>`	Deploy an auth middleware function

Command	Description
`quant search status`	Check search index status
`quant search index --path=<file>`	Index search records
`quant search unindex`	Remove from search index
`quant search clear`	Clear the entire search index

Command	Description
`quant scan`	Validate local file checksums against deployed content
`quant waf:logs`	Access project WAF logs

quant file ./images/logo.png /images/logo.png

quant redirect /old-page /new-page 301

quant purge "/blog/*"

quant function ./my-function.js "My edge function"

The CLI works with any static site generator that outputs HTML, CSS, JavaScript, and assets to a build directory:

Point the CLI at your generator’s output directory during quant init.

The quant.json file stores your project configuration:

{
  "endpoint": "https://api.quantcdn.io",
  "clientid": "your-org",
  "project": "your-project",
  "token": "your-token",
  "dir": "dist"
}