https://github.com/Kotlin/kotlin-fullstack-sample

Kotlin Full-stack Application Example
https://github.com/Kotlin/kotlin-fullstack-sample

full-stack kotlin sample web-app

Last synced: 18 days ago
JSON representation

Kotlin Full-stack Application Example

• Host: GitHub
• URL: https://github.com/Kotlin/kotlin-fullstack-sample
• Owner: Kotlin
• License: apache-2.0
• Archived: true
• Created: 2016-12-14T15:40:53.000Z (almost 8 years ago)
• Default Branch: master
• Last Pushed: 2020-03-31T09:27:27.000Z (over 4 years ago)
• Last Synced: 2024-08-01T01:31:01.322Z (4 months ago)
• Topics: full-stack, kotlin, sample, web-app
• Language: Kotlin
• Homepage: https://kotlinlang.org
• Size: 197 KB
• Stars: 1,215
• Watchers: 67
• Forks: 168
• Open Issues: 25
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-kotlin - kotlin-fullstack-sample - Kotlin Full-stack Application Example (Samples)
• trackawesomelist - Kotlin/kotlin-fullstack-sample (⭐1.2k) - Kotlin Full-stack Application Example. (Recently Updated / [Oct 28, 2024](/content/2024/10/28/README.md))
• awesome-kotlin-android - kotlin-fullstack-sample - kotlin 全栈开发应用例子，包括前端和后台 🔥🔥🔥🔥 (DEMO / 测试)

README

        
# Warning

This sample uses plugins, which will be deprecated.

There is a [new repository](https://github.com/Kotlin/kotlin-full-stack-application-demo) with actual Kotlin version and Kotlin/JS Gradle plugin.

# Thinkter: A Kotlin Full-stack Application Example

Thinkter is an example of a full-stack Web application built with Kotlin. The backend runs on the JVM, and the browser

front-end uses React. The example implements a very simple microblogging application.

## Backend

The backend of Thinkter is built using [Ktor](https://github.com/kotlin/ktor), a Web framework built by the Kotlin team.

For data persistence, it uses [H2](https://www.h2database.com), allowing you to run the example without the need to configure

an external SQL server. The HTTP server implementation is provided by [Jetty](https://www.eclipse.org/jetty/).

To run the backend, use `./gradlew backend:run`, or open Thinkter as a project in IntelliJ IDEA and execute the shared 

run configuration `Backend :: Jetty`. This will start serving the REST API of the backend on port 9090.

## Frontend

The frontend of Thinkter is built using [React](https://facebook.github.io/react/). To adapt the React APIs to Kotlin,

it incorporates a set of [wrappers](https://github.com/orangy/thinkter/tree/master/frontend/src/org/jetbrains/react), which

you can also use in your projects and adapt to your needs.

The project is built using webpack and the [Kotlin frontend plugin](https://github.com/kotlin/kotlin-frontend-plugin). 

To run the frontend, use `./gradlew frontend:run`. This will start a webpack server on port 8080. Navigate to http://localhost:8080 

to start using the application.