The Publishing Project

Finally learning how to uses gulp-newer

One of the nice things about Gulp workflows if that you can minimize the amount of work that you have to do if you use the tools correctly.

I just discovered today that I wasn’t using gulp-newer properly. It’s almost an RTFM moment so I’m documenting it to prevent it from happening to me again 🙁

The idea behind gulp-newer is to reduce the number of files that we work on in a Gulp task by only passing around the files that are newer than the same file on the destination directory. For this technique to work you have to tell Newer what are you comparing with and yes, you guessed it, I never did.

The working example below taken from gulp-newer‘s Readme shows how the plugin works.

const gulp = require('gulp');
const newer = require('gulp-newer');
const imagemin = require('gulp-imagemin');

const imgSrc = 'src/img/**';
const imgDest = 'build/img';

// Minify any new images
gulp.task('images', function() {

  // Add the newer pipe to pass through newer images only
  return gulp.src(imgSrc)


The plugin will take all images in the src directory and compare them with the same images in the destination directory. If any of the sources images are newer, they will be processed with Imagemin but if they are not, they will be skipped.

The key is the parameter to newer that tells it where to look for the files to compare with. Without the parameter, it can’t do its work.