Embrace Web CLI for uploading sourcemaps and versioning bundles
npm install @embrace-io/web-cliThis tool is intended to help with build-time tasks for the Embrace Web SDK.
npm:
``sh`
npm install --save-dev @embrace-io/web-cli
yarn:
`sh`
yarn add -D @embrace-io/web-cli
To upload sourcemaps to Embrace as part of your build process you will require the following:
* Your Embrace App ID
* Your Embrace Symbol Upload API token (found in your Embrace dashboard in
Settings->API)
* The path to where the built JS files live
`sh`
npx embrace-web-cli upload -a "YOUR_EMBRACE_APP_ID" -t "YOUR_EMBRACE_UPLOAD_API_TOKEN" -p "BUILD_PATH"
> [!WARNING]
> The CLI must be run BEFORE the files are packaged (e.g., before creating a Docker image or deployment archive).
> The CLI injects a comment and a short function to the end of bundle files to enable symbolication, so it needs to
> happen before packaging.
The same upload sub-command as above can be used to inject your app's version into your bundle if the value is only
known at build time. If the version is known prior to build time you can provide it when initializing the SDK as
described in Keeping your app version up-to-date.
Execute the same command as above while also providing your app's version:
`sh``
npx embrace-web-cli upload -a "YOUR_EMBRACE_APP_ID" -t "YOUR_EMBRACE_UPLOAD_API_TOKEN" -p "BUILD_PATH" --app-version "APP_VERSION"