Skip to content
Switch branches/tags
Go to file


Build Status MIT

A chat demo that evaluates several technologies (and hopefully shows best practices)

Used Technologies


  • Java 8 JDK (or later) installed

  • JavaScript tooling like Node.js, Grunt CLI, Bower and TSD (TypeScript Definition Manager) doesn’t have to be installed manually, it will be installed automatically (and project local) during the Gradle build.

Getting Started

  • ./gradlew build (builds all, both Java and TypeScript)

  • ./gradlew bootrun (starts a server using port 8080)

  • Open http://localhost:8080 in a web browser

  • Open http://localhost:8080 in another web browser

  • Play around with Chatty!



Hypermedia API

Here is an example what you get at http://localhost:8080/api/users. I am using HAL (Hypertext Application Language). The returned mime type is application/hal+json. To get a pretty print in Chrome, please install the Chrome extensions JSONView and application/…+json|+xml as inline.

  "_embedded" : {
    "chatty:users" : [ {
      "fullName" : "Jane Doe",
      "email" : "",
      "_links" : {
        "self" : {
          "href" : "http://localhost:8080/api/users/doe_ja"
        "chatty:user" : {
          "href" : "http://localhost:8080/api/users/doe_ja{?projection}",
          "templated" : true
        "chatty:messages" : {
          "href" : "http://localhost:8080/api/users/doe_ja/messages"
    } ]

Spring Boot

To run the Spring-Boot based server, invoke gradlew bootrun

Then you can use http://localhost:8080/api as entry point for exploring the HAL based API.

  "_links": {
    "chatty:users": {
      "href": "http://localhost:8080/api/users{?page,size,sort,projection}",
      "templated": true
    "chatty:messages": {
      "href": "http://localhost:8080/api/messages{?page,size,sort,projection}",
      "templated": true
    "chatty:buildinfo": {
      "href": "http://localhost:8080/api/buildinfo"
    "profile": {
      "href": "http://localhost:8080/api/profile"
    "curies": [
        "href": "http://localhost:8080/api/../docs/{rel}.html",
        "name": "chatty",
        "templated": true

HAL Browser

After having started the Spring Boot based server, you can use http://localhost:8080/api/hal-browser/browser.html#/api/ as entry point for exploring the HAL based API with the embedded HAL-Browser.

HAL Explorer Integration

Additionally to the HAL-browser, you can build and integrate the HAL Explorer. Then you have to invoke ./gradlew build cloneHalBrowser ./gradlew -p subprojects/hal-browser build

Live Demo

Currently the Spring Boot based server is deployed to Heroku. You can try out a live demo of chatty at

The demos include a HAL browser for browsing Chatty’s RESTful hypermedia API, as well as documentation of the REST API created with Spring Restdocs. But please be aware that this is only a test installment and will be reset periodically.

Docker Integration

You find installation instructions at Docker. When you use Windows or MAC, install Docker Toolbox. To prepare the docker image creation you have to run 'gradlew build createDockerfile distTar'. Under Windows and MAC you want to create a VM with docker-machine and connect to it. Then you can create the images and start up a container for the Spring Boot based service (running on port 8080) by invoking: docker-compose up

Pebble Client


A chat app demo with RESTful hypermedia API and server push.




No releases published


No packages published