npm tasks for grunt-maven-plugin 1.2+
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


Deprecation note

This plugin will no longer be maintained. I can accept pull requests with some minor improvements and release new versions, but there will be no active development.

It has been almost two years since we moved from Maven to Gradle in most of our projects at Allegro. Since we don't use the plugin nor even Maven, it is impossible to notice what new features are needed as frontend tools develop.

If you are looking for a simple replacement, try frontend-maven-plugin.

npm tasks for grunt-maven-plugin.

grunt-maven-plugin NPM tasks power Maven+Grunt integrated workflow. These tasks depend on properties file produced by grunt-maven-plugin, which contains paths and options derived from projects pom.xml.

Getting started

Add plugin dependency to your package.json:

"devDependencies": {
  "grunt-maven": "~1.1.0",

Load tasks in Gruntfile:


mavenPrepare task


This tasks role is to copy raw sources from Maven webapp sources to target-grunt, where Grunt tasks will be executed. In your project's Gruntfile, add a section named mavenPrepare to the data object passed into grunt.initConfig().

  mavenPrepare: {
    options: {
      resources: ['**']
    dev: {
    prod: {
      resources: ['**', '!dev/**']



Type: Array

List of patterns that will be evaluated using minimatch to choose resources that will be copied from Maven webapp to target-grunt.

mavenDist task


mavenDist task copies artifacts produced by Grunt (less -> css, minified JS) from target-grunt to target-grunt/dist and from target-grunt to Maven WAR directory.

  mavenDist: {
    options: {
      warName: 'war',
      deliverables: ['**', '!non-deliverable.js'],
      gruntDistDir: 'dist'
    dev: {
      warName: 'war-dev'



Type: String

Name of WAR directory, residing in /target/, to which all deliverables will be copied.


Type: Array

List of patterns that will be evaluated using minimatch to choose deliverables that will be copied from target-grunt/ to target-grunt/dist and to WAR.


Type: String Default: Directory where gruntfile is located

Deliverable patterns will be matched relative to this path, and all returned filepaths will also be relative to this path.


Type: String Default: dist

Name of directory residing in target-grunt, where all deliverables will be copied.

Using maven* tasks

Each defined task that wants to operate on resources from Maven, should start with mavenPrepare and end with mavenDist, for example:

grunt.registerTask('default', ['mavenPrepare', 'jshint', 'karma', 'less', 'uglify', 'mavenDist']);
  • prepare environment in target-grunt
  • run all Grunt specific tasks in target-grunt
  • copy deliverables to WAR


Using grunt-contrib-watch can be very useful to create good development environment, just register whatever task you should need to run on resources change, using properties generated by grunt-maven-plugin to obtain watch path:

    gruntMavenProperties: grunt.file.readJSON('grunt-maven.json'),

    watch: {
        maven: {
            files: ['<%= gruntMavenProperties.filesToWatch %>'],
            tasks: 'default'

gruntMavenProperties.filesToWatch evaluates to /src/main/webapp/statics_dir/**. If you need to exclude some resources from being watched (although you probably shouldn't need to), use gruntMavenProperties.directoryToWatch. This is simply path to directory without globing pattern appended, in our case: /src/main/webapp/statics_dir.


grunt-maven-plugin NPM tasks are published under Apache License 2.0.