github vaadin/platform 21.0.0
Vaadin 21.0.0
on GitHub

latest releases: 24.6.0.alpha3, 23.5.10, 24.5.4...
3 years ago

Vaadin 21.0.0

Vaadin 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.

New and Noteworthy Since Vaadin 20

Here are the highlighted new and improved features in vaadin 21. To see the full list of bug fixes and improvements, check Included Projects and Change Log.

Flow

  • Spring Security helpers for Vaadin Flow
    • With improved helpers in vaadin-flow and vaadin-spring, we should make it easier, faster, and safer for Vaadin developers to utilize Spring security in their web apps.
  • RouteScope for Flow Spring integration
    • With this feature, you can share beans/component-state inside a route between different UI subparts/fragments, So that you can use DI to inject the beans to the route classes and control when state is shared and when cleaned up
    • It is possible to keep your RouteScoped beans to be the same after refresh (together with PreserveOnRefresh)
    • Make it easier for migrating your Vaadin 8 app to Latest

Fusion

  • Fusion TypeScript code generation nullability change
    • Previously, all the Java types are generated as required in TypeScript. Now it changes so that for any type that is nullable in Java, it is optional in TypeScript, that is, the value could be undefined.

Vaadin Components

  • new feature in Vaadin Charts
    • Server-side feature in Vaadin Charts for exporting a chart as SVG image data.
  • new Event type in Vaadin Grid
    • A Grid event that is thrown when a cell is focused.
  • Generic types support for vaadin-grid, vaadin-combo-box and vaadin-crud web components
    • Custom type parameter that enables getting items property, and other public properties, methods and events typed automatically.
  • Lumo utility classes
    • A set of utility css classes for common styling needs.

Vaadin Collaboration Engine

  • Introduce PresenceManager API
    • New API to set the user presence in a topic, keep track of the users who are currently present, and react to changes in the presence.

Known Issue

  • FrontendUtils fails to find pnpm if only the newer version is installed Issue
  • Endpoints stop working in Safari after first refresh Issue
    These two issues will be fixed in the following maintenance release.

Support

Vaadin 21 is supported for one month after Vaadin 22 has been released. The latest LTS (long term support) version is Vaadin 14. More details of our release model are available on our roadmap page.

Vaadin also provides commercial support and warranty.

Included Projects and Change Log

Vaadin 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.

Java Web Framework

Components

Vaadin Web Components

All listed Vaadin web components' version are using 21.0.0

Vaadin flow components

All listed Vaadin components' Java integration follows the Vaadin version 21.0.0

  • Vaadin Accordion
  • Vaadin App Layout
  • Vaadin Avatar
  • Vaadin Button
  • Vaadin Checkbox
    • Checkbox
    • Checkbox Group
  • Vaadin Combo Box
  • Vaadin Context Menu
  • Vaadin Custom Field
  • Vaadin Date Picker
  • Vaadin Date Time Picker
  • Vaadin Details
  • Vaadin Dialog
  • Vaadin Form Layout
  • Vaadin Grid
    • Grid
    • Tree Grid
    • Grid Context Menu
  • Vaadin Icons
  • Vaadin Item
  • Vaadin List Box
  • Vaadin Login
  • Vaadin Menu Bar
  • Vaadin Messages
  • Vaadin Notification
  • Vaadin Ordered Layout
    • Horizontal Layout
    • Vertical Layout
    • Flex Layout
  • Vaadin Progress Bar
  • Vaadin Radio Button
    • Radio Button
    • Radio Button Group
  • Vaadin Select
  • Vaadin Split Layout
  • Vaadin Tabs
  • Vaadin Text Field
    • Text Field
    • Text Area
    • Password Field
    • Big Decimal Field
    • Email Field
    • Integer Field
    • Number Field
  • Vaadin Time Picker
  • Vaadin Upload
  • Vaadin Virtual List
  • Vaadin Board (PRO)
  • Vaadin Charts (PRO)
  • Vaadin Confirm Dialog (PRO)
  • Vaadin Cookie Consent (PRO)
  • Vaadin Crud (PRO)
  • Vaadin Grid Pro (PRO)
  • Vaadin Rich Text Editor (PRO)

Themes

All listed Vaadin themes' version are sharing 21.0.0

  • Vaadin Lumo theme
  • Vaadin Material theme

Router

Collaboration Engine

  • Vaadin Collaboration Engine (3.2.0)

Tools

Getting Started with Vaadin

App starters

The best way to get started with Vaadin is to go to https://start.vaadin.com and configure your new application by setting up your views, entities, styles, and the technology stack you’re interested in.

Note

Vaadin 21 starters are not available just yet in vaadin.com. You can use Vaadin 20 starter and manually change Vaadin version (see instructions below).

Maven Archetypes

Maven is the de-facto build tool for Java web applications. Major IDEs also support Maven out of the box and most often you'll be using Maven via your favorite IDE.

There are currently two Maven archetypes available, the vaadin-archetype-application which corresponds to the project base for Flow and the corresponding vaadin-archetype-spring-application if you prefer use Flow with Spring.

The version of the archetype should match the platform version. After you have Maven installed, you can quickly create and run a Vaadin app with the following command: 

mvn -B archetype:generate \
                -DarchetypeGroupId=com.vaadin \
                -DarchetypeArtifactId=vaadin-archetype-application \
                -DarchetypeVersion=21.0.0 \
                -DgroupId=org.test \
                -DartifactId=vaadin-app \
                -Dversion=1.0-SNAPSHOT \
                && cd vaadin-app \
                && mvn

mvn -B archetype:generate \
                -DarchetypeGroupId=com.vaadin \
                -DarchetypeArtifactId=vaadin-archetype-spring-application \
                -DarchetypeVersion=21.0.0 \
                -DgroupId=org.test \
                -DartifactId=vaadin-app \
                -Dversion=1.0-SNAPSHOT \
                && cd vaadin-app \
                && mvn

Manually changing Vaadin version for Java projects

Add the following dependency to dependencyManagement in pom.xml. 

<dependency>
    <groupId>com.vaadin</groupId>
    <artifactId>vaadin-bom</artifactId>
    <version>21.0.0</version>
    <type>pom</type>
    <scope>import</scope>
</dependency>

Read more about upgrading to Vaadin 20 from vaadin.com.

Supported Technologies

Operating Systems

Development is supported with the following operating systems:

  • Windows
  • Linux
  • macOS

Desktop Browsers

  • Evergreen versions of the following browsers :
    • Chrome on the operating systems supported by the product.
    • Firefox on the supported platforms
    • Safari on macOS 10.15 or later
    • Edge Chromium on the systems supported by the vendor.

Mobile Browsers

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

  • Safari starting from iOS 13
  • Google Chrome evergreen on Android (requiring Android 5.0 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 and Visual Studio Code among others (including Emacs and Vim).

Vaadin Designer supports the following IDEs:

  • Eclipse Java EE versions: Photon, 2018 and 2019.
  • JetBrains IntelliJ IDEA 2017, 2018 and 2019. Community or Ultimate edition.

Java

Vaadin supports version 8, 11 and 17 of any JDK or JREs. More about Java support in FAQ.

Maven and Gradle

  • Maven: vaadin supports Maven 3.5 or newer versions
  • Gradle: vaadin supports Gradle 5.0 or newer versions

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
  • Apache TomEE 7.0.4->
  • Oracle WebLogic Server 12.2.1
  • IBM WebSphere Application Server 8.5 Liberty Profile and 9
  • RedHat JBoss EAP 7
  • WildFly 14, 15, 16
  • Jetty 9.4
  • Payara Server
  • Payara Micro
  • Karaf (4.2+)

Supported Node.js and npm versions

A supported version of Node.js: 10.x, 12.x, 14.x or newer.

Known Issues and Limitations

Flow

  • The Template-in-Template feature has some limitations
  • Links matching the context do not result in browser page load by default, instead they are handled with application routing. To opt-out, set the router-ignore attribute on the anchor element. This opt-out is needed for cases when native browser navigation is necessary, e. g., when using Anchor to link a StreamResource download.

OSGi support

See https://vaadin.com/docs/latest/flow/integrations/osgi/basic

Migrating from Vaadin 8

See the migration guide

Migrating from Vaadin 10-14

See the migration guide

Migrating from Vaadin 15 to Vaadin 20

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 or enhancement request:

  1. If you encounter an issue with the TypeScript and HTML API of Vaadin components, the repository is https://github.com/vaadin/web-components
  2. If you encounter an issue with the Java API of Vaadin components, the repository is https://github.com/vaadin/flow-components
  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
Check out latest releases or
releases around vaadin/platform 21.0.0

Don't miss a new platform release

NewReleases is sending notifications on new releases.

Get notifications