The gulp plugin `gulp-order` allows you to reorder a stream of files using the same syntax as of `gulp.src`.
Last updated 2 years ago by sirlantis .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install gulp-order 
SYNC missed versions from official npm registry.


The gulp plugin gulp-order allows you to reorder a stream of files using the same syntax as of gulp.src.


Assume you want to concatenate the following files in the given order (with gulp-concat):

  • vendor/js1.js
  • vendor/**/*.{coffee,js}
  • app/
  • app/**/*.{coffee,js}

You'll need two streams:

  • A stream that emits the JavaScript files, and
  • a stream that emits the compiled CoffeeScript files.

To combine the streams you can pipe into another gulp.src or use es.merge (from event-stream). But you'll notice that in both cases the files are emitted in the same order as they come in - and this can seem very random. With gulp-order you can reorder the files.


require("gulp-order") returns a function that takes an array of patterns (as gulp.src would take).

var order = require("gulp-order");
var coffee = require("gulp-coffee");
var concat = require("gulp-concat");

  .pipe(gulp.src("**/*.js")) // gulp.src passes through input

  // When passing gulp.src stream directly to order, don't include path source/scripts in the order paths.
  // They should be relative to the /**/*.js.


  // ...
  .pipe(order([...], options))


Some plugins might provide a wrong base on the Vinyl file objects. base allows you to set a base directory (for example: your application root directory) for all files.


Uses minimatch for matching.


  • Try to move your ordering out of your gulp.src(...) calls into order(...) instead.
  • You can see the order of the outputted files with gulp-print


If your files aren't being ordered in the manner that you expect, try adding the base option.

Alternative Approaches



MIT - Copyright © 2014 Marcel Jackwerth

Current Tags

  • 1.2.0                                ...           latest (2 years ago)

9 Versions

  • 1.2.0                                ...           2 years ago
  • 1.1.1                                ...           6 years ago
  • 1.1.0                                ...           6 years ago
  • 1.0.6                                ...           6 years ago
  • 1.0.5                                ...           6 years ago
  • 1.0.4                                ...           6 years ago
  • 1.0.3                                ...           6 years ago
  • 1.0.1                                ...           6 years ago
  • 1.0.0                                ...           6 years ago
Today 10
This Week 57
This Month 127
Last Day 18
Last Week 110
Last Month 324
Dependencies (3)
Dev Dependencies (4)

Copyright 2014 - 2016 © |