github vaadin/platform 10.0.21
Vaadin 10.0.21
on GitHub

latest releases: 24.5.3, 14.12.3, 24.5.2...
2 years ago

Vaadin 10.0.21

The Vaadin platform consists of a set of web components, a Java web framework, configurable themes, tools and a set of app templates.

Visit vaadin.com to get started.

Support

Vaadin 10 is an LTS (long term support) version, which will be supported at least for 5 years after the GA (general availability) release. Learn more about the support.

New and Noteworthy

Please see the release blog post in vaadin.com

Changes since 10.0.20

  • Vaadin Flow (1.0.17)
    • Security upgrade org.jsoup:jsoup to 1.15.3
      The following vulnerability are fixed with the upgrade: https://snyk.io/vuln/SNYK-JAVA-ORGJSOUP-2989728
      • Important Note: Upgrading jsoup from 1.14.3 to 1.15.3 includes an API breaking change and it might prevents the compilation of your code (only if you had a any direct usage of the removed deprecated class org.jsoup.safety.Whitelist). This was necessary to fix the potential security vulnerability listed above, and it is recommended to upgrade to this version. If you happened to have a compile error in your application, simply replace any possible occurrences of org.jsoup.safety.Whitelist with org.jsoup.safety.Safelist and there should not be any other hassles.

Included Projects and Change Log

The Vaadin platform includes the following projects. Release notes with detailed change logs for each project are linked below.

Projects marked as (PRO) are available for users with Pro or Prime subscriptions. Everything else is free and open source.

Components

Themes

Java Web Framework

  • Vaadin Flow (1.0.17)
  • Maven Plugin for Flow (1.0.17)
  • Maven Plugin for Vaadin 1.0.17
  • Vaadin Spring Addon 10.2.0

Tools

  • Vaadin Designer (PRO) (3.0.6)
  • Vaadin TestBench (PRO) (6.0.1)

App Starters

All app starters are available at https://vaadin.com/start

Getting Started with Vaadin 10

The best way to get started with Vaadin 10 is to go to https://vaadin.com/start and pick an app template for the technology stack you’re interested in. There are two types of app templates available.

The Project Bases are for starting your project from scratch with only the necessary dependencies and a couple of placeholder files available.

There are also full application examples available like Bakery (Pro) and Beverage Buddy. Those show you some opinionated examples on how to build different types of applications, with optionally integrating to a backend.

Getting Started Manually

For frontend projects you can get the dependencies with Bower by running bower install vaadin#10.0.21 or bower install vaadin-core#10.0.21.

For Java projects, an example of the necessary setup can be found from the Project Base.

Supported Technologies

Operating Systems

Development is supported with the following operating systems, for any OS version that supports either frontend development (Bower as package manager) or Java 8

  • Windows
  • Linux
  • macOS

Desktop Browsers

  • Evergreen versions of the following browsers on :
    • Chrome on these operating systems:
      • Windows 7, Windows 8.1, Windows 10 or later
      • macOS 10.9 (OS X Mavericks) or later
      • 64-bit Ubuntu 14.04+, Debian 8+, openSUSE 13.3+, or Fedora Linux 24+
    • Firefox on these operating systems
      • Windows 7, Windows 8.1, Windows 10 or later
      • macOS 10.9 (OS X Mavericks) or later
      • Any Linux with the following packages:
        • GTK+ 3.4 or higher
        • GLib 2.22 or higher
        • Pango 1.14 or higher
        • X.Org 1.0 or higher (1.7 or higher is recommended)
        • libstdc++ 4.6.1 or higher
      • Note: Firefox ESR is not considered as evergreen and therefore is not officially supported.
    • Safari on macOS 10.9 (OS X Mavericks) or later
    • Edge on Windows 10 or later
  • Internet Explorer 11 on Windows 7, Windows 8 and Windows 10
    • (preliminary support, see Known Issues and Limitations below)
    • supported only in production mode. See documentation for more information.

Mobile Browsers

The following built-in browsers in the following mobile operating systems:

  • Safari starting from iOS 9
  • Google Chrome evergreen on Android (requiring Android 4.4 or newer)

Development environments

Any IDE or editor that works with the language of your choice should work well. Our teams often use Eclipse, IntelliJ, Atom, VS.code among others (including Emacs and Vim).

Vaadin Designer supports the following IDEs:

  • Eclipse Java EE versions: Mars, Neon and Oxygen
  • JetBrains IntelliJ IDEA 2016, 2017 and 2018. Community or Ultimate edition.

Java Related Technologies and Tooling Support

The included Java parts are compatible with Java 8 and newer.

Application Servers

Vaadin Flow requires Java Servlet API 3.1 (JSR-340) or newer. It is tested on:

  • Apache Tomcat 8.0.x, 8.5, 9
  • Oracle WebLogic Server 12.2.1
  • IBM WebSphere Application Server 8.5 Liberty and 9
  • RedHat JBoss EAP 7
  • WildFly 8, 9, 10, 11, 12
  • Jetty 9
  • Payara Server
  • Payara Micro

Known Issues and Limitations

Flow

  • The Template-in-Template feature has some limitations
  • CDI support is available as an add-on, version 10.0 is compatible with V10 and V11. The add-on is included in the platform starting from V12.
  • OSGi support is available starting from Vaadin 12 (Dec. 5th 2018)

Designer

  • External preview doesn't work on IE11.
  • Horizontal scrolling using the trackpad doesn't work on macOS Eclipse.

Migrating from Vaadin 8

See the migration guide

Reporting Issues

We appreciate if you try to find the most relevant repository to report the issue in. If it is not obvious which project to add issues to, you are always welcome to report any issue at https://github.com/vaadin/platform/issues.

A few rules of thumb will help you and us in finding the correct repository for the issue:

  1. If you encounter an issue when using the HTML/JS API of a component or the component renders incorrectly, the problem is likely in the web component. The web component repositories are named like https://github.com/vaadin/vaadin-button
  2. If you encounter an issue when using the Java API of a component, the problem is likely in the Flow integration of the web component. The Flow component integration repositories are named like https://github.com/vaadin/vaadin-button-flow
  3. If you encounter an issue with Flow which does not seem to be related to a specific component, the problem is likely in Flow itself. The Flow repository is https://github.com/vaadin/flow
  4. If you encounter an issue with Designer, the repository is https://github.com/vaadin/designer
  5. If you encounter an issue with TestBench, the repository is https://github.com/vaadin/testbench
  6. If you encounter issues with code or the UI in any of the app starters, the corresponding repositories are:
    a) https://github.com/vaadin/bakery-app-starter-issues for Bakery
    b) https://github.com/vaadin/beverage-starter-flow for Beverage Buddy
    c) https://github.com/vaadin/skeleton-starter-flow for Flow project base
    d) https://github.com/vaadin/skeleton-starter-flow for Flow and Spring Boot project base
    e) https://github.com/vaadin/generator-polymer-init-vaadin-elements-app for Polymer project base
    f) https://github.com/vaadin/base-starter-angular for Angular project base
    g) https://github.com/vaadin/base-starter-react for React project base
    h) https://github.com/vaadin/base-starter-vue for Vue project base
Check out latest releases or
releases around vaadin/platform 10.0.21

Don't miss a new platform release

NewReleases is sending notifications on new releases.

Get notifications