Get started with the Content CLI

The Quant Content CLI (quant) deploys static sites and manages content on QuantCDN. This page walks through installation, initialising a project, and your first deploy. For full per-command details, see the commands reference.

Looking for the Cloud CLI?

For managing applications, environments, and infrastructure on Quant Cloud, see the Cloud CLI instead.

Requirements

• Node.js 20 or higher — check with node --version
• npm — included with Node.js

Install

Install the CLI globally via npm:

npm install -g @quantcdn/quant-cli

Verify the installation:

quant --version

Initialise a project

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/v1
• Client ID — your organisation ID (from your dashboard URL)
• Project — the project machine name
• Token — your project API token (from the Integrations section of the dashboard)
• Directory — the folder containing your static assets (e.g. dist, build, public)

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

Non-interactive initialisation

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

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

See quant init for the full flag list.

Deploy your first site

Deploy all content from the configured directory:

quant deploy

This pushes any files changed since the previous deployment. By default, content removed locally is unpublished from the CDN, and affected paths are purged from cache.

For deploy flags (concurrency, skip-unpublish patterns, advanced options like --revision-log), see quant deploy.

Configuration file

The quant.json file stores your project configuration:

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

Caution

Don’t commit quant.json to version control if it contains your API token. Add it to .gitignore and use environment variables (QUANT_CUSTOMER, QUANT_PROJECT, QUANT_TOKEN) in CI/CD instead.

Static site generators

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

Generator	Default output
Astro	dist/
Next.js (static export)	out/
Gatsby	public/
Hugo	public/
Jekyll	_site/
Eleventy	_site/
Docusaurus	build/
VitePress	.vitepress/dist/
MkDocs	site/

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

Where to next

• Commands reference — every command, flag, and example.
• CI/CD pipelines — automate deployments with GitHub Actions, GitLab CI, and more.
• Edge functions — deploy serverless functions at the edge with quant function.