vaadin-on-kotlin

Writing full-stack statically-typed web apps on JVM can't get any simpler

This project is maintained by mvysny

Index Getting Started

Vaadin-on-Kotlin

Vaadin-on-Kotlin (or VoK for short) is a web-application framework that includes everything necessary to create database-backed web applications in server-side Kotlin:

button("Create") {
  onLeftClick { db { person.save() } }
}

No JavaEE nor Spring needed; all complex features are deliberately left out, which makes Vaadin-on-Kotlin a perfect starting point for beginner programmers.

With VoK you only write server-side Kotlin code - no JavaScript and no CSS is necessary until much later on, when you decide to style up your application and/or write your own custom rich component.

VoK is not yet another HTTP route mapping library. On the contrary: it provides you with a wide palette of built-in powerful components: lazy paged tables, color pickers, menu components, sliders; allows drag’n’drop between those components. All components have rich JavaScript facade which provides rich functionality. Vaadin transparently handles the state synchronisation between the client part and the server part of the component which allows you to focus on wiring the components in pure server-side Kotlin code.

Because of that, VoK feels more of a client widget library (such as JavaFX) than a web page-based framework.

QuickStart

You will only need Java 8 JDK and git installed to run the example application from the command-line. Just type this into your terminal:

git clone https://github.com/mvysny/vaadin-on-kotlin
cd vaadin-on-kotlin
./gradlew vok-example-crud-sql2o:appRun

The web app will be running at http://localhost:8080

Tutorial

To get started with Vaadin-on-Kotlin, Start Here. To find out more, please visit the Vaadin-on-Kotlin GitHub project page.

To see the old JPA-based tutorial, Start Here

This work is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License