Repository navigation
docs: update Hilla Gradle reference for Vaadin 25 - #6365
Merged
Merged
Conversation
Correct the stale facts on the Hilla Gradle reference page: the requirements, the starter ZIP branch, the plugin versions in the build file examples, the build file name in the project tree, and the Hilla plugin options and tasks that changed when the Hilla Gradle plugin was merged into the Vaadin Gradle plugin. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Contributor
Preview DeploymentThis PR has been deployed for preview. URL: https://docs-preview-pr-6365.fly.dev Changed pagesAdded content is highlighted in green; removed content is marked in red on each page.
Built from 38f33e3 |
peholmst
added a commit
that referenced
this pull request
Oct 10, 2026
…#6367) Co-authored-by: Petter Holmström <petter@vaadin.com> Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
7 tasks
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Follow-up to #6364, which updated the other Gradle pages for Vaadin 25 and left this page out on purpose. Hilla docs are being migrated, so this PR only corrects facts and doesn't restructure the page.
Fixes in
articles/hilla/reference/gradle.adocVersion and build file fixes
articles/compatibility.adocandGRADLE_MINIMUM_SUPPORTED_VERSION = "8.14"in vaadin/flowFlowPlugin.kt, which is the same on the25.0,25.3, andmainbranches.FrontendToolson Flow25.3requires 24.0, and onmain(25.4) it requires 26.4. This follows the wording docs: update outdated Gradle information for Vaadin 25 #6364 uses on the other Gradle pages.tag::requirements[]. Grepping the repo fortag=requirementsandtags=requirementsfinds nothing, so changing the list affects only this page.v25branch instead ofv24.gh api repos/vaadin/skeleton-starter-hilla-react-gradle/branches --paginatelistsv2,v24,v25, andmain.v25is the default branch and is current (Vaadin 25.3.1), whilemainis stale (Hilla 2.1). The archive URL resolves (302 to codeload).org.springframework.bootchanged from3.0.6to{spring-boot-version}, andio.spring.dependency-managementfrom1.1.0to1.1.7. The page now includes_vaadin-version.adoc, the same wayarticles/flow/configuration/gradle.adocdoes. The v25 starter'sbuild.gradleuses Spring Boot 4.1.0 and dependency-management 1.1.7, and 1.1.7 is the latest release in Maven Central's metadata for the plugin.vaadin-devexclusion removed: the example no longer excludesvaadin-devfromvaadin-spring-boot-starter. That dependency isn't transitive in Vaadin 25: the 25.3.1 POMs ofvaadin-spring-boot-starterandvaadin-core-internaldon't list it. This now matches the v25 starter'sbuild.gradle.gradle.properties: "set the Hilla version" now says "set the Vaadin version", and the example usesvaadinVersion={vaadin-version}instead of a hard-coded25.0.0, as in docs: update outdated Gradle information for Vaadin 25 #6364.gradle.buildchanged tobuild.gradle.Hilla plugin fixes (found while comparing the page with the plugin source)
exposedPackagesToParserremoved: thehilla { exposedPackagesToParser = ... }option and its note are gone.EngineProjectExtension, which defined thehillaextension, was removed from vaadin/hilla in 24.7, and the option doesn't exist on any 25.x branch. A build file using it would fail. In its place, a short paragraph says that services in dependencies and other modules need no build configuration, and links to the Multi-Module section of the Hilla Configuration page and to the Explicit Discovery section on this page. That Configuration section is where the Maven docs already cover this.hillaConfigure: removed the claim that the task writesbuild/hilla-engine-configuration.json. In 25.x,EngineConfigureTaskonly callsEngineAutoConfiguration.setDefault(...). For the same reason, thehillaGeneratedescription no longer says it "reads the configuration file".com.vaadin, which vaadin/platform builds from the Hilla plugin sources together withflow-gradle-plugin.vaadinPrepareFrontendandvaadinBuildFrontendnow links to Gradle Configuration Properties. The Getting Started page it linked to doesn't describe those tasks.Verification
vale articles/hilla/reference/gradle.adoc: 0 errors and 0 warnings. Before this change, there was 1 error (Gradle Pluginin a block title) and 2 warnings (AOTundefined), and this PR fixes them.{vaadin-version}and{spring-boot-version}resolve inside thesubs="normal"blocks, and the new xrefs resolve tocompatibility,flow/configuration/gradle,configuration, and#_endpoint_discovery.articles/hilla/litis untouched. No page moves, so no redirect is needed.Not changed
themes/andviews/helloworld/HelloWorldView.tsx, while the v25 starter usesviews/@index.tsxandviews/@layout.tsxand has nothemes/folder. Updating it would also mean rewriting the Hilla Lit note under it, which goes beyond correcting facts.providedRuntime 'org.springframework.boot:spring-boot-starter-tomcat', while the Spring Boot 4.1 docs now recommendspring-boot-starter-tomcat-runtime.articles/flow/configuration/gradle.adochas the same line, so both should be changed together.🤖 Generated with Claude Code