bugsee-sourcemaps is a CLI tool that generates and uploads sourcemaps to Bugsee servers from JavaScript-based projects.


# using NPM
npm install -g bugsee-sourcemaps

# using Yarn
yarn global add bugsee-sourcemaps


    $ bugsee-sourcemaps <command> <options> <project-dir>


        -h, --help
        -t, --app-token,
        -v, --app-version,
        -s, --source-map,
        -b, --bundle,
        -e, --endpoint,
        -p, --platform,
        -c, --configuration,
        -o, --overwrite


Option Required Compatible commands Description
-t, --app-token Yes make, upload, generate Application token that identifies the app in Bugsee you want to upload sourcemaps for
-v, --app-version No make, generate, upload Lets Bugsee to associate sourcemaps with the specified application version. We recommend to set this manually to make sure there will be no any differences in versions of sourcemaps and crash reports
-s, --source-map Yes upload Path to the generated sourcemaps (file)
-b, --bundle Yes upload Path to the generated bundle (file)
-e, --endpoint No upload, make Defines the upload endpoint
-p, --platform Yes make, generate, upload Identifies the platform sourcemaps are generated for. Available values are: 'ios' and 'android'
-c No* make, generate, upload Defines the configuration to use when handling the sourcemaps. Available values: 'debug' and 'release'.
*Note that this option is required for upload command as there is no way to easily found out for which configuration sourcemap was generated.For other commands, if omitted, sourcemaps will be generated for both debug and release configurations.
-o, --overwrite No make, upload Instructs the tool to overwrite any existing sourcemaps of the same version, build configuration and platform


  • make: This command is a union of generate and upload. It automatically generates sourcemaps and uploads them to Bugsee servers.
  • generate: This command instructs the tool to trigger sourcemaps generation for the specified project.
  • upload: This command instructs the tool to upload the specified sourcemaps to the Bugsee servers.