kotlin-full-stack-application-demo

Fork of https://github.com/mkraynov/kfsad with the new Kotlin/JS Gradle Plugin

A full-stack demo application written in Kotlin for JetBrains Night Moscow 2019.

Run application

• ./gradlew :server:run will build optimized application bundle and run it on https://localhost:8080 (it takes some time to build optimized js bundle, so it is not useful for frontend development)
• ./gradlew :client:run -t will run development application at https://localhost:8080 with live reload. It runs ktor and webpack dev servers under the hood:
  • Webpack dev server will be started at the front https://localhost:8080.
  • Ktor server will be spawned internally at https://localhost:8081 in separate gradle process (webpack devserver will start it)
  • Webpack dev server will call ktor for everything expect *.js files.

Distribution

• ./gradlew :server:build will create server/build/distributions/server-0.1.1.zip. You can deploy it on the server and run bin/server to start the server. Client is included into the lib/server.jar

Description

This application displays a feed containing user-generated posts and comments. All data is stubbed by the fakeJSON and JSON Placeholder services.

It is a Kotlin Multiplatform project.

It uses:

• kotlin-multiplatform, kotlin-js and kotlin-jvm plugins for Kotlin compilation;
• Ktor framework as a web server;
• H2 in-memory database with Exposed to preload posts at application startup;
• kotlinx.serialization for client/server (de-)serialization and RPC;
• React, Styled components, Ring UI 2.0 and kotlin-wrappers for rendering.

During application startup posts are preloaded to the in-memory database from the fakeJSON (or JSON Placeholder) service. When the user requests the page, several posts are selected from the DB and the corresponding comments are fetched via the multi-platform HTTP client. Posts with comments are served to the client via RPC. After the initial render is done, information about authors is fetched via the client-side HTTP client and rendered after all coroutines terminate successfully. The "Load more comments" button fetches additional comments for the post using the multi-platform HTTP client.

This application has no error handling and has very limited RPC serialization. It's not meant for production use and serves only as a technology example.

Contact information

Please refer original repo: https://github.com/mkraynov/kfsad