mbland/gradle-node-plugin

Gradle plugin for integrating NodeJS in your build. :rocket:

Gradle Plugin for Node

This plugin enables you to use a lot of Node.js-based technologies as part of your build without having Node.js installed locally on your system. It integrates the following Node.js-based system with Gradle:

• Node.js
• npm
• Yarn
• pnpm

The plugin is published in the Gradle plugins portal with the com.github.node-gradle.node identifier.

It supports Gradle 6.6+ and Node.js 10+, for Gradle 5.6.4 support use version 3.x

Documentation

⚠️ This is the documentation of the development version. See below in the releases history to read the documentation of the version you're using.

Here's how you get started using this plugin. If you do not find what you are looking for, please add an issue to GitHub Issues.

• Installation
• Usage
• FAQ
• Changelog
• Example Projects

Releases History

Here's the documentation for older releases of the plugin:

• 7.0.1 (current)
• 6.0.0
• 5.0.0
• 4.0.0
• 3.6.0
• 3.5.1
• 3.5.0
• 3.4.0
• 3.3.0
• 3.2.1
• 3.2.0
• 3.1.1
• 3.1.0
• 3.0.1
• 3.0.0
• 2.2.4
• 2.2.3
• 2.2.2
• 2.2.1
• 2.2.0
• 2.1.1
• 2.1.0
• 2.0.0
• 1.5.3
• 1.4.0

Building the Plugin

Prerequisites

Some integration test ensure that this plugin is able to use the globally installed Node.js, npm or yarn tools. This requires those tools are globally installed on your system in order to get all integration tests pass.

Command

To build the plugin, just type the following command:

./gradlew build

The integration tests are run using multiple Gradle versions to ensure it works on all supported versions. But this takes a lot of time. To speed up the build, the tests run only on the current Gradle versions. To run the tests against all Gradle versions, use the following option (it is done by the CI).

./gradlew build -PtestAllSupportedGradleVersions=true

Contributing

Contributions are always welcome! If you'd like to contribute (and we hope you do) please send one of the existing contributors a nudge.

Support this project ❤️

This plugin is open source project and completely free to use. If you are using this project in your products/projects, please consider sponsoring to ensure it is actively developed and maintained.

Donate via PayPal (one time)

License

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.