Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?


Failed to load latest commit information.


Build Status Maven Central

sbt-scala-js-map is a Sbt plugin that configures source mapping for Scala.js projects hosted on Github.


I have some Scala.js libraries hosted on Github (Binding.scala and some private libraries). Then, other Scala.js applications would depend on these libraries. When I debug the Scala.js application in a browser, I want to see the Scala source files of the original libraries.

However, by default, the generated * files maps the generated JavaScript to the absolute Scala source path where the original library compiled. For me, the path is on a Travis CI worker, like /home/travis/build/ThoughtWorksInc/.../Binding.scala. The path obviously does not exist on my local computer that debugs the application. Too bad.

This sbt plugin detects if a library is hosted on Github repository and let source map point to instead of a local file path.


Browse then open the inspector of your browser. You will be able to debug the Scala.js code in your browser now.

Debugging Scala.js

Alternative options

An alternative option is specifying Scala.js's relative source mappings flag.

However, this approach enforce library users cloning the library's source files into their local file system before debugging their applications.

On the other hand, libraries published with this plugin enable the library users to view the source (of correct revision), automatically.


Step 1: Add the dependencies in your Scala.js library's project/plugins.sbt

addSbtPlugin("com.thoughtworks.sbt-scala-js-map" % "sbt-scala-js-map" % "latest.release")

Note that sbt-scala-js-map 2.x requires sbt 0.13.x, sbt-api-mappings 3.x requires sbt 1.x.

Step 2: Publish your Scala.js library

Execute the release command if you have setup sbt-release correctly。

sbt release

Step 3: Debug it!

Now switch your Scala.js application to the newly published Scala.js library, build it, browse your web page, and open the debugger in your browser. You will see the Scala source files hosted under and you can set break points at code lines in these Scala files.


A Sbt plugin that configures source mapping for Scala.js projects hosted on Github








No packages published