Telebugs 1.5.0: Introducing sourcemap support

Telebugs 1.5.0 adds support for JavaScript and TypeScript sourcemaps, releases, and more.

Kyrylo Silin
Kyrylo Silin
Telebugs founder

Debugging minified JavaScript errors just got a whole lot easier. Telebugs 1.5.0 now officially supports sourcemaps, allowing you to upload your JavaScript and TypeScript sourcemaps so Telebugs can automatically resolve minified backtraces to their original source code.

Sourcemaps are essential files that map your production-ready, minified code back to the readable source code you wrote, making it simpler to identify and fix issues.

I'm excited to announce that this has been the most requested feature since the very first release of Telebugs, and I'm thrilled to deliver it!

Sourcemaps in Telebugs 1.5.0 (React project)

Let's explore how sourcemaps work in Telebugs and what you need to get started.

What are releases?

In Telebugs, releases and sourcemaps are closely connected. A release is a snapshot of your application at a specific point in time, including the version number and deployment date. Each release can contain multiple sourcemap files that help resolve minified code back to its original form.

Screenshot of the Telebugs project dashboard highlighting the link to access releases

Access releases from your project dashboard.

Creating releases

There are two ways to create a release in Telebugs:

Manual creation

Go to the Releases tab in your project and click the Create release button. This opens a form where you can specify the version and other details.

Creating a release manually in the dashboard

Screenshot of the release management interface in Telebugs 1.5.0 showing sourcemap artifacts

Release management interface with sourcemap artifacts.

Automated creation with Sentry CLI

Telebugs is compatible with Sentry CLI, a command-line tool for managing releases and sourcemaps (originally from Sentry; see Sentry CLI documentation for installation and basics). This allows you to use existing deployment scripts. First, get your personal API key from the settings:

Screenshot of personal API key generation in Telebugs 1.5.0 settings

Generate your API key for CLI access.

Then use the sentry-cli releases new command to create a release:

Creating a release using Sentry CLI

Uploading sourcemaps

Once you have a release, you can attach sourcemaps to it using either method. Telebugs supports standard .map files generated by popular bundlers like Webpack, Rollup, or Vite.

Manual upload

When viewing a release, click the Attach artifacts button. You can upload multiple sourcemap files at once. Telebugs accepts both JavaScript and TypeScript sourcemaps.

Automated upload with CLI

Use the sentry-cli sourcemaps upload command with the --release option: 

sentry-cli sourcemaps upload --release=1.0.0 ./build

For modern workflows, you can also use: 

sentry-cli sourcemaps inject ./build
sentry-cli sourcemaps upload --release=1.0.0 ./build

The inject command embeds sourcemap references into your minified JavaScript files, ensuring they point to the correct maps during debugging.

Once uploaded, Telebugs automatically resolves minified backtraces to their original source code using the sourcemaps, saving you hours of debugging by showing errors in your original code. No additional configuration is needed.

Before and after screenshot showing a minified backtrace resolved to original source code using sourcemaps in Telebugs

Before and after: Minified vs. resolved backtrace with sourcemaps.

Conclusion

With sourcemap support, Telebugs provides a complete error tracking solution for modern JavaScript and TypeScript applications, empowering you to debug faster across frameworks like React, Vue, or Angular.

Sentry CLI compatibility makes integration easy—just update environment variables like SENTRY_URL to point to your Telebugs instance, and adapt your existing workflows.

Ready to get started? Learn more about Telebugs and see how it can simplify your error tracking workflow.

— Kyrylo