☕🍵🍶🍼🍺🍸🍹🍷

This is a Vaadin 14 Vaadin-on-Kotlin example application, used to demonstrate features of the Vaadin Flow Java framework. A full-stack app: uses the H2 database instead of a dummy service.

The Starter demonstrates the core Vaadin Flow concepts:

• Building UIs in Kotlin with components such as TextField, Button, ComboBox, DatePicker, VerticalLayout and Grid (see CategoriesList)
• Creating forms with Binder (ReviewEditorDialog)
• Making reusable Components on server side with KComposite (AbstractEditorDialog)
• Creating Navigation with the Router API (MainLayout, ReviewsList, CategoriesList)
• Browserless testing: see the test suite package for the complete test implementation.

This version of Beverage Buddy demoes the possibility of developing a Vaadin 14 web application purely server-side in the Kotlin language. There is no JavaScript code in this project. If you'd like to see a demo on how to create Polymer Templates, please head to the page of the original Beverage Buddy App (in Java).

You can find the Online Beverage Buddy Demo running on Heroku.

The Vaadin 14 build requires node.js and npm. Vaadin Gradle plugin will install those for you automatically (handy for the CI); alternatively you can install those to your OS:

• Windows: node.js Download site - use the .msi 64-bit installer
• Linux: sudo apt install npm

Also make sure that you have Java 8 (or higher) JDK installed.

To quickly start the app, just type this into your terminal:

git clone https://github.com/mvysny/beverage-buddy-vok
cd beverage-buddy-vok
./gradlew appRun

Gradle will automatically download an embedded servlet container (Jetty) and will run your app in it. Your app will be running on http://localhost:8080.

Since the build system is a Gradle file written in Kotlin, we suggest you use Intellij IDEA to edit the project files. The Community edition is enough to run the server via Gretty's ./gradlew appRun. The Ultimate edition will allow you to run the project in Tomcat - this is the recommended option for a real development.

Runs in Vaadin 14 npm mode, using the Vaadin Gradle Plugin.

Both the development and production modes are supported. To prepare for development mode, just run:

./gradlew clean vaadinPrepareFrontend

To build in production mode, just run:

./gradlew clean build -Pvaadin.productionMode

If you don't have node installed in your CI environment, Gradle Vaadin plugin will download node.js for you automatically:

./gradlew clean build -Pvaadin.productionMode

To compile the entire project in production mode, run ./gradlew -Pvaadin.productionMode.

To run the application in development mode, run ./gradlew appRun and open http://localhost:8080/.

To produce a deployable production-mode WAR:

• run ./gradlew -Pvaadin.productionMode
• You will find the WAR file in build/libs/*.war
• To revert your environment back to development mode, just run ./gradlew or ./gradlew vaadinPrepareFrontend (omit the -Pvaadin.productionMode) switch.

This will allow you to quickly start the example app and allow you to do some basic modifications.

Let's look at all files that this project is composed of, and what are the points where you'll add functionality:

For Vaadin 14 documentation for Java users, see Vaadin.com/docs.

For Vaadin-on-Kotlin documentation, head to Vaadin-on-Kotlin.

The easiest way (and the recommended way) to develop VoK-based web applications is to use Intellij IDEA Ultimate. It includes support for launching your project in any servlet container (Tomcat is recommended) and allows you to debug the code, modify the code and hot-redeploy the code into the running Tomcat instance, without having to restart Tomcat.

1. First, download Tomcat and register it into your Intellij IDEA properly: https://www.jetbrains.com/help/idea/2017.1/defining-application-servers-in-intellij-idea.html
2. Then just open this project in Intellij, simply by selecting File / Open... and click on the build.gradle file. When asked, select "Open as Project".
3. You can then create a launch configuration which will launch the web module as exploded in Tomcat with Intellij: just scroll to the end of this tutorial: https://kotlinlang.org/docs/tutorials/httpservlets.html
4. Start your newly created launch configuration in Debug mode. This way, you can modify the code and press Ctrl+F9 to hot-redeploy the code. This only redeploys java code though, to redeploy resources just press Ctrl+F10 and select "Update classes and resources"

Intellij Community is free and can be used for the development as well. To launch your app in IDEA Community, just click the rightmost Gradle tool button, then navigate to beverage-buddy-vok / Tasks / gretty / appRun, right-click appRun and select the first option "Run beverage-buddy-vok".