sbt-play-scalajs is a SBT plugin which allows you to use Scala.js along with Play Framework. It uses the sbt-web and scala-js plugins.
sbt-play-scalajs alternatives and similar packages
Based on the "Sbt plugins" category.
Alternatively, view sbt-play-scalajs alternatives based on common mentions on social networks and blogs.
9.0 4.4 sbt-play-scalajs VS sbt-assemblyDeploy über-JARs. Restart processes. (port of codahale/assembly-sbt)
sbt plugin to create a dependency graph for your project
7.8 6.7 sbt-play-scalajs VS sbteclipsePlugin for sbt to create Eclipse project definitions
7.4 0.0 sbt-play-scalajs VS sbt-revolverAn SBT plugin for dangerously fast development turnaround in Scala
7.4 0.0 sbt-play-scalajs VS sbt-jmh"Trust no one, bench everything." - sbt plugin for JMH (Java Microbenchmark Harness)
An sbt plugin to create awesome microsites for your project
A tool for catching binary incompatibility in Scala
sbt plugin to automate Sonatype releases from GitHub Actions
5.0 5.9 sbt-play-scalajs VS sbt-headersbt-header is an sbt plugin for creating file headers, e.g. copyright headers
4.2 5.5 sbt-play-scalajs VS sbt-unidocsbt plugin to create a unified Scaladoc or Javadoc API document across multiple subprojects.
An Sbt plugin that fills apiMappings for common Scala libraries.
Translates xml -> awesome. Maven-ish support for sbt.
SBT plugin for tweaking various IDE settings
A Sbt plugin that configures source mapping for Scala.js projects hosted on Github
Do you think we are missing an alternative of sbt-play-scalajs or a related project?
Specify the sbt version in
project/build.properties (you can find the latest version here):
Add the sbt-web-scalajs and Scala.js plugins to
addSbtPlugin("com.vmunier" % "sbt-web-scalajs" % "1.2.0") addSbtPlugin("org.scala-js" % "sbt-scalajs" % "1.5.1")
Lastly, put the following configuration in
lazy val server = project.settings( scalaJSProjects := Seq(client), Assets / pipelineStages := Seq(scalaJSPipeline) ).enablePlugins(SbtWeb) lazy val client = project.enablePlugins(ScalaJSPlugin, ScalaJSWeb)
Note: make sure you use the
To see the plugin in action, you can run
sbt new with one of these Giter8 templates:
- Play with Scala.js:
sbt new vmunier/play-scalajs.g8
- Akka HTTP with Scala.js:
sbt new vmunier/akka-http-scalajs.g8
Have a look at the releases to find out about the new features, bug fixes and how to upgrade when breaking changes were introduced.
sbt-web-scalajs looks up the
scalaJSStage setting from the Scala.js projects to know whether to run
scalaJSStagesetting is set to
FastOptStageby default, which means sbt-web-scalajs runs
scalaJSStage := FullOptStagecan be set in a Scala.js project, so that sbt-web-scalajs runs
fullLinkJSfor that project.
Global / scalaJSStage := FullOptStagesets
FullOptStagefor all the Scala.js projects from the build.
How it works
There are two plugins:
WebScalaJSis automatically added to your SbtWeb project.
ScalaJSWebshould be manually added to the Scala.js projects that are used by your SbtWeb project.
- Scala.js projects are collected in the
scalaJSProjectssetting key of the SbtWeb project. The plugin does nothing if
scalaJSProjectsis not specified or is empty.
- When compilation or testing takes place, then the
WebScalaJSplugin runs all required tasks on
scalaJSProjectsprojects, copies the output to sbt-web assets and takes care of Source Maps.
Settings and Tasks
scalaJSProjectssetting lists the Scala.js projects whose output are used by the server.
scalaJSPipeline performs the following tasks for each project defined in the
scalaJSStagesetting is equal to:
FastOptStage, then run
FullOptStage, then run
Read the ScalaJSWeb's
sourceMappingssetting from the project and its transitive dependencies.
sourceMappingslists the directories containing Scala files to be used for Source Maps. Copy all Scala files found in these directories to the sbt-web assets.
jsMappingstask runs Scala.js
fullLinkJSand convert output files to path mappings.
jsMappingsis scoped under
fullLinkJS. Let's have a look at the value of
> project client > show Compile/fastLinkJS/jsMappings [info] * (<path>/client/target/scala-2.13/client-fastopt/main.js.map,client-fastopt/main.js.map) [info] * (<path>/client/target/scala-2.13/client-fastopt/main.js,client-fastopt/main.js)
fastLinkJS, which creates two files:
main.js. The files are then converted to path mappings, i.e. a tuple of a file to a relative path. The
main.jsfile has a
main.jsto the server sbt-web assets under
We can extend
jsMappings to add the output of other Scala.js tasks. When using the sbt-jsdependencies plugin, we can update
jsMappings in build.sbt as follows:
import com.typesafe.sbt.web.PathMapping val client = project.settings( Compile / fastLinkJS / jsMappings += toPathMapping((Compile / packageJSDependencies).value), Compile / fullLinkJS / jsMappings += toPathMapping((Compile / packageMinifiedJSDependencies).value), ... ).enablePlugins(ScalaJSPlugin, ScalaJSWeb, JSDependenciesPlugin) def toPathMapping(f: File): PathMapping = f -> f.getName
sourceMappingssetting lists the directories containing Scala files to be used for Source Maps. The Scala files from the Scala.js project need to be copied and packaged, so that the server can serve these files to the browser when using Source Maps. Here's an example of what
> project client > show Compile/fastLinkJS/sourceMappings [info] * (<path>/client/src/main/scala, scala/ae0a44)The hash
ae0a44has been computed from the directory's canonical path using
sbt.io.Hash.trimHashString(f.getCanonicalPath, 6)and is used to configure the Scala.js
mapSourceURIscalac option. When generating Source Maps, Scala.js will replace the prefix path of each Scala file with its hash value. The hash uniquely identifies a file/directory and can be safely exposed to the users as the full file path is not disclosed.
The plugin copies the Scala files to the sbt-web assets, so that they can be served to the browser and used for Source Maps.
By default, Source Maps are enabled in both
However, Source Maps can easily be disabled in
fullLinkJS by adding the following line to the Scala.js project settings:
Compile / fullLinkJS / scalaJSLinkerConfig ~= (_.withSourceMap(false))
When Source Maps are disabled, the
.map files and the Scala files are not copied and do not exist in the sbt-web assets.
Note that Source Maps only get requested by the browser when the DevTools is open, so it does not hinder the performance of your website.
Scala.js continuous compilation
The plugin also watches files from the Scala.js projects.
compile to trigger
scalaJSPipeline when using
Compile / compile := ((Compile / compile) dependsOn scalaJSPipeline).value
Publish a new version of the plugin
New versions are automatically published to Sonatype when creating a git tag, thanks to sbt-ci-release.
*Note that all licence references and agreements mentioned in the sbt-play-scalajs README section above are relevant to that project's source code only.