README

Seed project for Play framework + ScalaJS using React, Apollo client and Sangria. Under the hood it uses:

• GraphQL
• Apollo Client
• Play framework
• Sangria
• Silhouette (Authentication)
• Slinky (React for Scala.js)
• Antd (Components for React)
• Slick with codegen and play-evolutions

Development Guide

Prerequisites

• Node installed on the dev box
• SBT installed on the dev box
• Follow the instructions in the file project/WebClient.scala
• If an error at build time appears saying that module style-loader cannot be found, run npm install -g style-loader css-loader

Setup

Follow the setup here for IntelliJ support.

The project needs a mysql database to work, if you are using docker you can run the following command to start it:

docker run --name=test_db_server -e 'MYSQL_ROOT_PASSWORD=root' -e 'MYSQL_ROOT_HOST=%' -e 'MYSQL_DATABASE=test' -p 3306:3306 -d mysql/mysql-server:5.7.19

Commands

• run: runs the server and live reloads the changes
• web_client/Compile/managedSources: generates schema.graphql and query/mutation objects for the client (you shouldn't need to use this explicitly)
• assembly: generates the uber jar

Usage

The default login for the user interface is:

• username: admin
• password: admin

It is created via evolutions, remove it from there if you want to change it. Also if you want to create another one manually there is an app called ManualUserGenerator to do that.

Problems

• WebpackDevServer is not used at the moment
• When a new dependency is added to the npmDependencies the bundle.js is not rebuilt.
• The build is slow because some files are not cached (static query generation and two rounds of js bundling) and the dist directory is deleted.
• Add test framework for front-end
• Refetching the queries instead of changing the apollo cache.

Credits

https://github.com/shadaj/create-react-scala-app.g8/tree/master/src/main/g8

https://github.com/boosh/play-scalajs-seed/blob/master/build.sbt

https://github.com/KyleU/boilerplay