Upgrading · Docs · Get Started
This is a pre-release for the Vaadin 25.4. We appreciate if you give it a try and report any issues you notice.
New and Noteworthy Since Vaadin 25.3
Platform
- Content Security Policy ready: Flow can now send a nonce-based
Content-Security-Policyheader and run withoutunsafe-eval. Setvaadin.csp=warnto log every call in your application that would break under a strict policy, then switch tostrict. Server-initiated JavaScript, event data, filters, shortcuts and Flow's own client code now run from the bundle instead ofeval. (📖 Docs) - Switch and Breadcrumbs are production ready: both components no longer need a feature flag.
- Leaner Spring dependencies:
vaadin-springno longer brings Spring MVC, Spring WebSocket or Hibernate Validator to your classpath. The Vaadin Spring Boot starter adds the websocket and validation starters, so Spring Boot apps keep working as before. Plain Spring apps must declare these dependencies themselves. - CDI add-on and Quarkus extension follow the Flow version: they are now developed in the Flow repository and versioned as 25.4.x. Their group and artifact IDs are unchanged.
- Node.js 26 is now the minimum supported version. If your global Node.js is older, Vaadin downloads Node.js 26 into
~/.vaadin. - SpringBoot 4.2 is the supported version in this Vaadin minor.
Flow
- Strict CSP and declared JavaScript: JavaScript can be declared in Java interfaces with
@JsDefinitionand@JsExpression, bundled at build time and called by id. Calls return typedJavaScriptResult<T>values.addEventDataPath()replaces the string-based event data API, which is now deprecated. - New HTML components:
NativeFormfor native<form>elements, such as login forms that work with password managers.Video,AudioandSourcefor the browser's media players, served from a URL or aDownloadHandler. (📖 Docs) - Downloads from any component:
Download.onClick()starts a download when any component is clicked, andOpenInNewTab.onClick()opens a URL or handler content in a new tab, with noAnchorneeded. File handlers support HTTP range requests, so media players can seek and downloads can resume. A UI stays alive while its upload or download is still running. (📖 Docs) - Hierarchical menus:
@Menu(parent = ...)andMenuConfiguration.getMenuEntriesTree()build nested navigation menus from your routes. - Lifecycle events: the service event bus now reports the start and end of every request and navigation, with outcome, duration and handler. Client-side
vaadin-requestandvaadin-server-messageevents let page scripts measure round trips. Observability Kit uses these events. - Spring Security:
VaadinSecurityConfigurercan choose the URL to go to after login, handle login failures, map Keycloak roles to Spring authorities, and handle expired sessions so that the client understands the response. Multiple@EnableVaadinannotations are now merged. - CSS cascade layers and runtime ES modules:
@StyleSheet(layer = "...")loads a stylesheet into a cascade layer, so its rules always lose to your own styles.@JavaScript(type = MODULE)loads an ES module at runtime without bundling it. (📖 Docs) - Also: null-safe converter helpers in
Binder,Component.findAncestor(predicate), the browser time zone inExtendedClientDetails,RouteConfiguration.getUrl()with query parameters, and a redesigned default PWA offline page.
Hilla
- TypeScript generated in Java: endpoint and model TypeScript is now generated by Java in the same run that scans your classes, with no Node.js process. Builds no longer need Node.js for this step.
TypeScriptProcessorlets build tools run the generation themselves. Breaking: the generator plugin configuration, thenodeCommandoption andhilla-openapi.jsonare removed. - New form models: generated form models are now
@vaadin/hilla-modelsconstants, and the legacy class-based lit-form models are removed. The new buildersm.record,m.literalandm.lazydescribe maps, literal values and circular references between models. - JSpecify
@NullMarkedpackages are treated as non-null by default, like Spring's@NonNullApi. (📖 Docs) - Also: Swagger, Jackson 2, SnakeYAML and gentyref are no longer transitive dependencies, and many generator fixes for Kotlin properties, generic parameters and unusual property names.
Design System
New components
- PDF Viewer (Pro): 🔬 Preview. Shows PDF documents inside your application, with page navigation, zoom and a toolbar. Tagged PDFs expose their structure to screen readers. Enable it with the
pdfViewerComponentfeature flag.
New in existing components
- Labels aside: a
LABEL_ASIDEtheme variant puts a field's label next to the input instead of above it. It works for text fields, combo boxes, pickers, select, checkbox and radio groups, custom field and slider. Form Layout gets a label text alignment setting. - Multi-Select Combo Box: a "Select all" button that selects or deselects all items, or all filtered items.
- Text Field: select text or move the cursor from the server with
setSelectionRange(),selectAll()andsetCursorPosition(). - Button: start a file download on click with
setDownloadHandler(). Context Menu and Menu Bar items can start downloads too.DisableOnClickMode.UNTIL_RESPONSEre-enables the button automatically after the server has handled the click. - Grid: select a row by clicking anywhere on it in multi-select mode,
getColumnBySortProperty(), and context menu content that knows the clicked column. - Also: look up the context menus attached to a component,
TabSheet.findTabContaining()andremoveAll(),Notification.getText(), camera capture in Upload, Map icons sized in pixels, Slider theme variants,submitDisabledin Message Input and AI chat while a request or upload is running, and AI Grid paging through yourDatabaseProvider.
Accessibility
- Heading levels for Dialog, Confirm Dialog and Card titles. Dialog supports
aria-describedby. Select is announced as a combobox. Date Picker calendar dates work better with VoiceOver and NVDA.
Breaking changes
- The web component
i18nproperty isundefineduntil you set it. A slotted Card title now wins overcardTitle. Date Picker calendar cells and Grid body cells have a new DOM, which may affect custom CSS and tests. Two-way signal bindings now require a write callback. See the upgrade guide.
Copilot
See the Vaadin Copilot documentation.
- Added an updated onboarding flow that guides users into identification.
- Added a redesigned sign-in dialog that supports signing in through the license checker.
- Added support for generating Browserless tests from the UI test recorder.
- Improved Kotlin views to honor the API-selection dialog.
- Added support for copying a component from a Kotlin view.
- Added experimental optimistic updates to make edit mode feel more responsive.
Testing
- Find elements by test ID in TestBench with
withTestId()andtestId(). - Browserless tests:
reload()simulates a browser reload. New testers forUploadButton,UploadDropZoneandUploadFileListcan simulate failed and aborted uploads.roundTrip()runs pendingUI.access()tasks. Each window gets its own UI. Lookup failure messages name the query conditions. - TestBench elements: read Grid cells in bulk,
GridSorterElement, the Multi-Select Combo Box "Select all" button, andPdfViewerElement.
Observability Kit (Pro)
- Browser interaction timing now works in production and with WebSocket push. Navigation, request and session lock metrics are measured from Flow's new lifecycle events, so they are more accurate.
Changelogs
- Flow (25.4.0-beta1) and Hilla (25.4.0-beta1)
- Design System
- Web Components (25.4.0-beta1)
- Flow Components (25.4.0-beta1)
- TestBench (25.4.0-beta1)
- Browserless Test(25.4.0-beta1)
- Feature Pack(25.0.0)
- Modernization Toolkit (Documentation)
- Feature Pack (Documentation)
- Dragonfly (Documentation)
- Modernization Toolkit Analyzer (Analyzer for Eclipse, Analyzer for Maven)
- Multiplatform Runtime (MPR) (25.4.0-beta1)
- Router (2.0.1)
- Vaadin Kits
- AppSec Kit (4.1.1)
- Azure Kit (1.0.0)
- Collaboration Engine (25.4.0-alpha1)
- Copilot (25.4.0-beta1)
- Kubernetes Kit (3.1.1)
- Observability Kit (25.4.0-alpha2)
- SSO Kit (4.2.0)
- Swing Kit (3.0.1)
Official add-ons and plugins:
- Spring add-on (25.4.0-beta1)
- CDI add-on (25.4.0-beta1)
- Maven plugin (25.4.0-beta1)
- Gradle plugin (25.4.0-beta1)
- Quarkus plugin (25.4.0-beta1)
Supported technologies
| Desktop browser |
|
|---|---|
| Mobile browser |
|
| Development OS |
|
| IDE |
Any IDE or editor that works with the language of your choice should work well. Our teams often use IntelliJ, Eclipse, VS Code among others. Vaadin IDE plugins (IntelliJ and VS Code) support the IDE versions released during the last 12 months Vaadin Designer supports the following IDEs:
|
| Java | Version 21 of any JDK or JRE |
| Maven | Version 3.8 or newer |
| Gradle | Version 8.14 or newer |
| Application server |
Vaadin Flow requires Java Servlet API 6.1 and Java 21 or newer. It is tested on:
|
| Node.js | Version 26.x |
| NPM | Version 11.3 or newer |
| PNPM | Version 10.16 or newer |
| Spring Boot | Version 4.2 |