/vertx-vaadin

Run Vaadin UI on Vert.x

Primary LanguageJavaMIT LicenseMIT

Vertx Vaadin

Status

License Build Status Download

Description

Vertx Vaadin is an adapter library that lets you run Vaadin applications on top of Vert.x. This means you can mix the simplicity and robustness of Vaadin applications with the powerful tools provided by Vert.x, such as event bus, clustering, High Availability and Fail-Over.

Installation and Getting Started

Vertx-vaadin binaries are available on Maven Central and Bintray.

Maven

<dependency>
  <groupId>com.github.mcollovati.vertx</groupId>
  <artifactId>vertx-vaadin8</artifactId>
  <version>0.4.0</version>
</dependency>

For snapshots:

<repository>
	<id>oss-jfrog-snapshots</id>
	<url>https://oss.jfrog.org/artifactory/oss-snapshot-local</url>
    <releases>
        <enabled>false</enabled>
    </releases>
    <snapshots>
        <enabled>true</enabled>
    </snapshots>	
</repository>

Gradle

compile 'com.github.mcollovati.vertx:vertx-vaadin8:0.4.0'

For snapshots:

repositories {
	maven { url 'https://oss.jfrog.org/artifactory/oss-snapshot-local' }
}

Documentation

See vertx-vaadin module for more information.

Demo and samples

A public demo based on Vaadin archetype application example is published on heroku and is available here

Source code and other samples can be found on vaadin-vertx-samples repository.

Issue tracking

The issues for this project are tracked on its github.com page. All bug reports and feature requests are appreciated.

Contributions

Contributions are welcome, but there are no guarantees that they are accepted as such. Process for contributing is the following:

  • Fork this project
  • Create an issue to this project about the contribution (bug or feature) if there is no such issue about it already. Try to keep the scope minimal.
  • Develop and test the fix or functionality carefully. Only include minimum amount of code needed to fix the issue.
  • Refer to the fixed issue in commit
  • Send a pull request for the original project
  • Comment on the original issue that you have implemented a fix for it

License

Vertx Vaadin is distributed under MIT License. For license terms, see LICENSE.

Acknowledgements

Thanks to David Sowerby (author of Krail framework) for all his precious technical and non technical support.