@fe-blackbox/cli

CLI tool for FE-Blackbox source map management.

Installation

npm install -g @fe-blackbox/cli

Or use it directly via npx:

npx @fe-blackbox/cli upload-sourcemaps --url <url> --project <id> --release <version> <files...>

Commands

upload-sourcemaps

Upload source map files to the FE-Blackbox collector for server-side stack trace symbolication.

fe-blackbox-cli upload-sourcemaps --url <collector-url> --project <project-id> --release <version> <files...>

Required Options

| Option | Description | | --- | --- | | --url | FE-Blackbox collector URL (e.g. http://localhost:3001) | | --project | Project identifier | | --release | Release version string |

Arguments

Provide one or more .map files or directories. When a directory is given, all .map files inside it are uploaded automatically.

Examples

Upload a single source map:

fe-blackbox-cli upload-sourcemaps \
  --url http://localhost:3001 \
  --project my-app \
  --release 1.2.0 \
  dist/assets/index-abc123.js.map

Upload all source maps in a directory:

fe-blackbox-cli upload-sourcemaps \
  --url http://localhost:3001 \
  --project my-app \
  --release 1.2.0 \
  dist/assets

CI Integration

Add source map uploads to your build pipeline:

# GitHub Actions example
- name: Upload source maps
  run: |
    npx @fe-blackbox/cli upload-sourcemaps \
      --url ${{ secrets.FE_BLACKBOX_URL }} \
      --project my-app \
      --release ${{ github.sha }} \
      dist/assets

License

MIT