Play+Scala.js Showcase
Scala CSS HTML JavaScript Shell
Latest commit 62e4e61 Jul 20, 2016 @hussachai committed on GitHub Update README.md

README.md

Play Framework with Scala.js Showcase

Scala: 2.11.6, Scala.js: 0.6.5, Play: 2.4.0, Slick: 3.0.0

Update: July 2016

This project was started on Oct 2014 when Scala.js was still an experimental project. I didn't expect Scala.js to come this far because there were a lot of Scala projects that were discontinued. Surprisingly, it's not just still alive but keeps growing. I have to catch up what I missed for almost 2 years, and start looking for something cool to learn as usual.(Stay hungry, still foolish LoL)
I'm looking forward to using this: https://github.com/japgolly/scalajs-react/tree/topic/neo
The new version I plan in my head is to use React and Microservice.


This is a small application showing how cool Scala.js is. You can share code across platforms. For the shared code, the Scala compiler compiles your Scala code to JVM byte code, and the ScalaJS compiler compiles the same Scala code to JavaScript. Beside CSS and a few lines of HTML, almost all code in this project are type-safety including HTML (Thanks to scalatags). I made this project for learning purpose during my summer intern. So, the code you will see in this project may look not good, but I hope you can learn something from it like I did. I will try to keep it update-to-date to make sure that it will run with the recent version of Scala.js.

The sbt build file contains 3 modules

  • exampleServer Play application (server side)
  • exampleClient Scala.js application (client side)
  • exampleShared Scala code that you want to share between the server and the client.

This project would not exist if I didn't find this kick-ass example play-with-scalajs-example.

The project contains 4 simple examples:

  • Todo application with backend persistence.(Modified from Todo application)
    • InMemory, Slick, Anorm, Gremlin (Selectable in application.conf)
  • Hangman (Inspired by Yii's demo)
  • HTML5 Fileupload (Modified from How to Use HTML5 File Drag and Drop)
  • Server Push Chat. It supports both Websocket and Server-Sent Event

Prerequisite steps

Before running the application, you may need to do these steps: 1. Add the folowing to ~/.sbt/0.13/plugins/plugins.sbt

addSbtPlugin("com.typesafe.sbteclipse" % "sbteclipse-plugin" % "4.0.0")

Run the application

$ sbt
> run
$ open http://localhost:9000

Run the application on heroku

$ heroku login
$ heroku create
$ git push heroku master
$ heroku open

Features

The application uses the sbt-play-scalajs sbt plugin and the play-scalajs-scripts library.

  • Run your application like a regular Play app
    • compile simply triggers the Scala.js compilation
    • run triggers the Scala.js fastOptJS command on page refresh
    • ~compile, ~run, continuous compilation is also available
    • start, stage and dist generate the optimised javascript
    • playscalajs.html.scripts selects the optimised javascript file when the application runs in prod mode (start, stage, dist).
  • Source maps
    • Open your browser dev tool to set breakpoints or to see the guilty line of code when an exception is thrown
    • Source Maps is disabled in production by default to prevent your users from seeing the source files. But it can easily be enabled in production too by setting emitSourceMaps in fullOptJS := true in the Scala.js projects.