Docs/CI / CD

Custom Setups

Any CI system that can run Node and accept environment variables can run Assrt. The requirements are the same across providers, so this page summarizes what any job needs to do.

Checklist

  • Node.js 20 or later installed and on PATH.
  • Dependencies installed (npm ci is the fastest option).
  • Browsers downloaded with assrt install-browsers. On Linux add --with-deps.
  • Secrets exposed as environment variables, not baked into the config.
  • Results directory uploaded as an artifact, even on failure, for debugging.

Minimal POSIX shell

bash
#!/usr/bin/env bash
set -euo pipefail

npm ci
npx assrt install-browsers --with-deps
npx assrt run --reporter junit
Trigger cloud runs instead
If you would rather have CI kick off tests and Assrt Cloud execute them, swap the run step for npx assrt run --cloud --wait and expose ASSRT_TOKEN as a secret.