Javascript Gradle Plugin Suite

leading image

A collection of Gradle plugins to deal with the JavaScript and TypeScript development environment in a very gradlesque way. It offers three primary use cases:

  • Developers that want to wrap Gradle around their JavaScript and TypeScript development to improve their build and deployment pipeline capability because Gradle is really awesome at this and the tools in the Node landscape simply do not match up.

  • Developers that deal with some node capability in their project for various reasons such as running a tool written in JavaScript ecosystem.

  • Gradle Plugin authors that want to embed node capabilities in their plugins in order to run tools but want to hide the complexity away from their users. A good example is the Asciidoctor Gradle plugin suite which uses this under the hood to run asciidoctor.js.

Like many software projects, frameworks, and plugins that started off, authors could not find a solution that really fitted their needs. This is one of those kinds of projects, and it is offered against a number of alternative solutions that are available as Gradle plugins.

The aim with the group of plugins is making the integration of node, pnpm related technologies into the build automation pipeline as smooth as possible. This brought with it a number of subgoals:

  • Simplicity to use defaults – convention over configuration

  • Maximum flexibility if you need it.

  • Removing as many node hurdles from the learning curve as possible.

  • No need to first install node or relevant tools - let Gradle take care of the bootstrapping.

  • Allow other developers/contributors of your projects to build it without fiddling with a big list of prerequisites.

  • Isolate builds from potential side effects due to global node installations.

Compatibility

Gradle

The minimum Gradle version required to run this plugin is 7.6.6. This plugin also has been tested against the following versions: 8.0.2, 8.14.5, 9.1.0, 9.7.0.

JRE

The minimum JRE version to run against is the higher of 8 and the minimum requirement of the specific Gradle version.

Node

The default version of node is 24.19.0. Testing has also been performed against 22.12.0, 20.18.1, 18.20.5.

Pnpm

The default version of pnpm is 11.17.0. Testing has also been performed against 10.33.4.

Support this project

Patreon If you like this project, consider donating to our Patreon account.

Discord We are on Discord. Click to join and then go to #javascript-gradle-plugin-suite.

Mastodon Follow us @ysb33rOrg@fosstodon.org in the #Fediverse