Vaadin Flow is the Java framework of Vaadin Platform for building modern web sites that look great, perform well and make you and your users happy.
To contribute, first refer to Contribution Guide for general instructions and requirements for contributing code to Flow.
Flow EAP discussion in Gitter IM at https://gitter.im/vaadin-flow/Lobby
Instructions on how to set up a working environment for developing the Flow project follow below.
master branch is the latest version (3.1) that will at some point be released in the Vaadin platform 16.0.0.
See other branches for other framework versions:
Note that the first compilation takes a while to finish as Maven downloads dependencies used in the projects.
Compile the client engine by executing the Eclipse build configuration Compile ClientEngine in flow-client/eclipse
The following preferences need to be set to keep the project consistent. You need to do this especially to be able to contribute changes to the project.
Line width: 72 Format comments: true Join lines: true Insert whitespace before closing empty end-tags: true Indent-using spaces: true Indentation size: 4
The unit tests for the projects can be run using
IT tests can be run with
To run IT tests locally, you'll need a Testbench license and a Chrome browser installed (currently this is the only browser that IT tests are run in). If you don't have the license, it's ok, our CI system will run those tests for you after you create a pull request. Refer to the contribution guide for details.
When running IT tests locally, by default, local Chrome is used to run tests, make sure it's installed.
The distribution package is built and installed into the local Maven repository by doing
Some flow internals use GWT in the client code. superDevMode allows to reload GWT changes on the fly, but it requires some setup first.
To start superDevMode do the following:
mvn -Psdm clean install gwt:compile gwt:run-codeserver -DskipTests
In eclipse run .launch files from flow-client/eclipse in the order:
NOTE! SuperDevMode should be compiled before the application server is launched, also, flow version should match with the application one as else the application won't be able to run SDM and you will receive the exception
Can't find any GWT Modules on this page.
More info about SuperDevMode: http://www.gwtproject.org/articles/superdevmode.html