Source Maps
Upload your source maps to Sentry to enable readable stack traces in your errors, along with other numerous benefits. Learn more here.
To enable readable stack traces in your Sentry errors, you need to upload your source maps to Sentry. Learn how to unminify your JavaScript code by watching this video or reading the step-by-step instructions below.
The easiest way to configure uploading source maps is by using the Sentry Wizard:
npx @sentry/wizard@latest -i sourcemaps
The wizard will guide you through the following steps:
- Logging into Sentry and selecting a project
- Installing the necessary Sentry packages
- Configuring your build tool to generate and upload source maps
- Configuring your CI to upload source maps
This guide assumes you are using a Browser JavaScript SDK. For instructions on how to set up source maps for React Native, follow the source maps guide for React Native.
If you want to configure source maps to upload manually, follow the guide for your bundler or build tool below.
If you used Create React App to set up your React application see our Create React App guide to upload source maps.
-
TypeScript (tsc)
If you're using one of webpack, Vite, Rollup, or Esbuild, use the corresponding Sentry plugin instead (see section "Sentry Bundler Support").
- UglifyJS
- SystemJS
- GitHub Actions
If you're not using one of these tools, we assume you already know how to generate source maps with your toolchain and we recommend you upload them using Sentry CLI.
Though we strongly recommend uploading source maps as part of your build process, for browser applications it's also possible to host your source maps publicly.
Our documentation is open source and available on GitHub. Your contributions are welcome, whether fixing a typo (drat!) or suggesting an update ("yeah, this would be better").