feat(maven): introduce maven plugin WIP #32947

FrozenPandaz · 2025-10-03T14:30:48Z

This is still WIP

Current Behavior

There is no first-party Maven support for Nx

Expected Behavior

Maven Support is ready for usage.

Related Issue(s)

Fixes #

vercel · 2025-10-03T14:30:55Z

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Preview	Updated (UTC)
nx-dev	Ready	Preview	Oct 7, 2025 8:22pm

netlify · 2025-10-03T14:30:56Z

✅ Deploy Preview for nx-docs ready!

Name	Link
🔨 Latest commit	`b96461c`
🔍 Latest deploy log	https://app.netlify.com/projects/nx-docs/deploys/68e570b10d346700087455c5
😎 Deploy Preview	https://deploy-preview-32947--nx-docs.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

nx-cloud · 2025-10-03T14:31:43Z

View your CI Pipeline Execution ↗ for commit b96461c

Command	Status	Duration	Result
`nx documentation`	❌ Failed	4m 58s	View ↗

☁️ Nx Cloud last updated this comment at 2025-10-07 20:35:00 UTC

github-actions · 2025-10-06T15:04:50Z

Failed to publish a PR release of this pull request, triggered by @FrozenPandaz.
See the failed workflow run at: https://github.com/nrwl/nx/actions/runs/18285305766

github-actions · 2025-10-06T15:16:41Z

Failed to publish a PR release of this pull request, triggered by @FrozenPandaz.
See the failed workflow run at: https://github.com/nrwl/nx/actions/runs/18285666201

…ntation

github-actions · 2025-10-06T16:49:45Z

Failed to publish a PR release of this pull request, triggered by @FrozenPandaz.
See the failed workflow run at: https://github.com/nrwl/nx/actions/runs/18285926077

github-actions · 2025-10-06T17:25:59Z

Failed to publish a PR release of this pull request, triggered by @FrozenPandaz.
See the failed workflow run at: https://github.com/nrwl/nx/actions/runs/18288244241

github-actions · 2025-10-06T17:53:25Z

Failed to publish a PR release of this pull request, triggered by @FrozenPandaz.
See the failed workflow run at: https://github.com/nrwl/nx/actions/runs/18288244241

nx-cloud

Nx Cloud has identified a possible root cause for your failed CI:

Failure Classification: environment_state

The nx-maven-plugin:install task failed with "/bin/sh: 1: mvn: not found", indicating that the Maven executable is not available in the CI/CD build environment's PATH.

Analysis Details:

The PR introduces a new Maven plugin with extensive Maven build infrastructure
A Maven wrapper (mvnw) exists at the repository root and was added in this PR
The project.json configuration for nx-maven-plugin uses "mvn install" directly
The build environment does not have Maven installed in PATH

Why This Is environment_state (Not code_change):

The error is not caused by any code logic in the PR
This is a missing system dependency in the execution environment
The Maven wrapper (mvnw) exists and should be used, but the environment is not configured to use it
No similar failures in other branches suggest this is environment-specific
The code changes themselves are valid; the issue is purely environmental

Recommendation:
The build environment needs either:

Maven installed in PATH, OR
The project.json should be updated to use "./mvnw" instead of "mvn", OR
The CI/CD pipeline should be configured to set up Maven before running the build

This is not a code fix that should be implemented as part of this PR review. The failure is due to environment configuration, not the PR's code changes.

A code change would likely not resolve this issue, so no action was taken.

View in Nx Cloud ↗

_{⚙️ An Nx Cloud workspace admin can disable these reviews in workspace settings.}

github-actions · 2025-10-06T19:24:21Z

Failed to publish a PR release of this pull request, triggered by @FrozenPandaz.
See the failed workflow run at: https://github.com/nrwl/nx/actions/runs/18291507296

Adds automatic detection of Maven projects during nx init by looking for Maven wrapper files (mvnw, mvnw.bat) and pom.xml files. When detected, suggests installing the @nx/maven plugin, similar to how Gradle projects are detected.

Restructures the Java documentation sidebar to have separate subsections for Gradle and Maven plugins, instead of only showing Gradle at the top level. This provides equal visibility to both build tools.

- Move Gradle-specific docs from java/introduction.mdoc to java/gradle/introduction.mdoc - Create new general Java overview at java/introduction.mdoc covering both build tools - Remove special case remapping of gradle to java in plugin-mappings.ts - Both Gradle and Maven now have equal footing in the documentation structure This addresses the TODO comment about not having Gradle as the default Java docs now that Maven is available.

Fix broken links to Gradle and Maven introduction pages by using the full path including /introduction suffix.

github-actions · 2025-10-06T19:42:04Z

🐳 We have a release for that!

This PR has a release associated with it. You can try it out using this command:

npx [email protected] my-workspace

Or just copy this version and use it in your own command:

0.0.0-pr-32947-aa25f06

Release details	📑
Published version	0.0.0-pr-32947-aa25f06
Triggered by	@FrozenPandaz
Branch	maven-plugin
Commit	aa25f06
Workflow run	18291507296

To request a new release for this pull request, mention someone from the Nx team or the @nrwl/nx-pipelines-reviewers.

Add index.mdoc landing pages for the Gradle and Maven subdirectories to resolve broken links to /docs/technologies/java/gradle and /docs/technologies/java/maven.

github-actions · 2025-10-06T20:48:42Z

Failed to publish a PR release of this pull request, triggered by @FrozenPandaz.
See the failed workflow run at: https://github.com/nrwl/nx/actions/runs/18293215975

FrozenPandaz requested review from jaysoo, AgentEnder, a team, vsavkin, meeroslav and JamesHenry as code owners October 3, 2025 14:30

FrozenPandaz marked this pull request as draft October 3, 2025 14:30

This comment was marked as outdated.

Sign in to view

vercel bot had a problem deploying to Preview October 3, 2025 14:56 Failure

FrozenPandaz force-pushed the maven-plugin branch from ef194e7 to b6a36aa Compare October 3, 2025 15:10

This comment was marked as outdated.

Sign in to view

vercel bot had a problem deploying to Preview October 3, 2025 15:34 Failure

vercel bot had a problem deploying to Preview October 3, 2025 16:37 Failure

This comment was marked as outdated.

Sign in to view

vercel bot had a problem deploying to Preview October 3, 2025 18:25 Failure

This comment was marked as outdated.

Sign in to view

vercel bot deployed to Preview October 3, 2025 20:11 View deployment

This comment was marked as outdated.

Sign in to view

vercel bot deployed to Preview October 6, 2025 14:27 View deployment

vercel bot deployed to Preview October 6, 2025 15:43 View deployment

FrozenPandaz had a problem deploying to npm-registry October 6, 2025 15:50 — with GitHub Actions Failure

FrozenPandaz added 2 commits October 6, 2025 12:47

fix(maven): replace maven-javadoc-plugin with dokka for Kotlin docume…

cd77702

…ntation

chore(repo): checkout nx-release.ts from master

7d6ca22

FrozenPandaz force-pushed the maven-plugin branch from 8b37724 to 7d6ca22 Compare October 6, 2025 16:47

vercel bot deployed to Preview October 6, 2025 17:01 View deployment

FrozenPandaz had a problem deploying to npm-registry October 6, 2025 17:15 — with GitHub Actions Failure

FrozenPandaz had a problem deploying to npm-registry October 6, 2025 17:47 — with GitHub Actions Failure

fix(maven): add missing npm package metadata fields

aa25f06

FrozenPandaz force-pushed the maven-plugin branch from 691e022 to aa25f06 Compare October 6, 2025 17:54

This comment was marked as outdated.

Sign in to view

vercel bot deployed to Preview October 6, 2025 18:14 View deployment

chore(repo): add mvn wrapper

ef22d3f

nx-cloud bot reviewed Oct 6, 2025

View reviewed changes

vercel bot deployed to Preview October 6, 2025 19:25 View deployment

FrozenPandaz added 4 commits October 6, 2025 15:26

feat(core): add Maven detection to nx init

dc183a0

Adds automatic detection of Maven projects during nx init by looking for Maven wrapper files (mvnw, mvnw.bat) and pom.xml files. When detected, suggests installing the @nx/maven plugin, similar to how Gradle projects are detected.

docs(nx-dev): restructure Java sidebar to include both Gradle and Maven

37b9585

Restructures the Java documentation sidebar to have separate subsections for Gradle and Maven plugins, instead of only showing Gradle at the top level. This provides equal visibility to both build tools.

fix(nx-dev): correct links in Java introduction page

d40b017

Fix broken links to Gradle and Maven introduction pages by using the full path including /introduction suffix.

fix(nx-dev): add index pages for Gradle and Maven subdirectories

8942e82

Add index.mdoc landing pages for the Gradle and Maven subdirectories to resolve broken links to /docs/technologies/java/gradle and /docs/technologies/java/maven.

vercel bot deployed to Preview October 6, 2025 20:36 View deployment

FrozenPandaz had a problem deploying to npm-registry October 6, 2025 20:46 — with GitHub Actions Failure

chore(misc): fix publishing

d48ca5c

FrozenPandaz force-pushed the maven-plugin branch from 0fc52f6 to d48ca5c Compare October 7, 2025 19:49

docs(nx-dev): add java introduction page to sidebar

b96461c

vercel bot deployed to Preview October 7, 2025 20:22 View deployment

feat(maven): introduce maven plugin WIP #32947

Are you sure you want to change the base?

feat(maven): introduce maven plugin WIP #32947

Uh oh!

Conversation

FrozenPandaz commented Oct 3, 2025

This is still WIP

Current Behavior

Expected Behavior

Related Issue(s)

Uh oh!

vercel bot commented Oct 3, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

netlify bot commented Oct 3, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

✅ Deploy Preview for nx-docs ready!

Uh oh!

nx-cloud bot commented Oct 3, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

This comment was marked as outdated.

Uh oh!

This comment was marked as outdated.

Uh oh!

This comment was marked as outdated.

Uh oh!

This comment was marked as outdated.

Uh oh!

This comment was marked as outdated.

Uh oh!

github-actions bot commented Oct 6, 2025

Uh oh!

github-actions bot commented Oct 6, 2025

Uh oh!

github-actions bot commented Oct 6, 2025

Uh oh!

github-actions bot commented Oct 6, 2025

Uh oh!

github-actions bot commented Oct 6, 2025

Uh oh!

This comment was marked as outdated.

Uh oh!

nx-cloud bot left a comment

Choose a reason for hiding this comment

Nx Cloud has identified a possible root cause for your failed CI:

Uh oh!

github-actions bot commented Oct 6, 2025

Uh oh!

github-actions bot commented Oct 6, 2025

🐳 We have a release for that!

Uh oh!

github-actions bot commented Oct 6, 2025

Uh oh!

Uh oh!

vercel bot commented Oct 3, 2025 •

edited

Loading

netlify bot commented Oct 3, 2025 •

edited

Loading

nx-cloud bot commented Oct 3, 2025 •

edited

Loading