API reference
@fixback/cli reference
The complete surface of
@fixback/cli. For how sourcemaps fit into capture, see the Source maps guide.sourcemaps upload
FIXBACK_SECRET_KEY=sk_… npx @fixback/cli sourcemaps upload <dir>Scans <dir> for JavaScript sourcemaps and uploads each, keyed by a release, so
captured stack traces can be symbolicated. The binary is exposed as fixback.
Flags
| Flag | Default | Description |
|---|---|---|
--release <r> | $FIXBACK_RELEASE, else a CI commit SHA, else git HEAD SHA | Build identifier (1–100 visible chars, no spaces or slashes). |
--url-prefix <p> | ~/ | Where bundles are served relative to the site root, e.g. ~/static. |
--api-url <u> | $FIXBACK_API_URL, else the hosted API | Point at a self-hosted deployment. |
--key <sk_…> | $FIXBACK_SECRET_KEY | Project secret key. |
--dry-run | — | List what would upload; no network, no key needed. |
Environment variables
| Variable | Maps to |
|---|---|
FIXBACK_SECRET_KEY | --key |
FIXBACK_RELEASE | --release |
FIXBACK_API_URL | --api-url |
Preview without uploading
npx @fixback/cli sourcemaps upload ./dist --dry-run--dry-run needs no key and makes no network calls — handy for verifying the CLI finds your maps in CI.