How can I upload JavaScript Source Maps via Zipy CLI?

Created by Zipy Inc, Modified on Fri, 24 Mar, 2023 at 12:34 PM by Zipy Inc

Zipy CLI helps in debugging the minified stack trace that occurs on the user's browser environment. The minified stack trace can be parsed, so that you can see the actual source code with the help of source maps. This lets you view the actual source context of the frontend JavaScript errors, including the code from any other libraries that you may have used in your frontend code.

How to enable this feature?
To activate this feature, you must upload the source maps to the Zipy Server using the CLI. For seamless integration, install the package globally and incorporate it into your build steps. Additionally, make certain that you have recorded the release version when initializing Zipy.
Here are the steps for uploading source map files:

// Globally install the cli package -
npm i -g zipy-cli

// CLI Command -
zipy-cli --authKey authKey --dirname ~/sourcemaps/ --apiKey zipyProjectKey --releaseVer releaseVerString

// CLI help command -
zipy-cli --help

Below are the params accepted by the CLI:

authKey: It is an authentication key for your Zipy projects.
dirname: A string value of the directory where source maps are available
apiKey: Zipy Project Key
releaseVer: Release Version of your application

Please contact Zipy at support@zipy.ai to get an authorization key for access. Note that you can upload only up to 100 and a maximum of 100 MB files at once.

Why can't I see the proper stack trace?

If you are unable to see the proper stack trace in your Zipy dev tools section, please verify the following:

1. Check if you initialized the SDK with a proper release version. Make sure the release version for which the sourcemaps have been uploaded matches with SDK init release version.

2. Confirm if you uploaded all the source map files. Stack traces can be broken if some souce map files are missing.