Broccoli plugin to merge multiple trees into one
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.


Build Status Build status

Copy multiple trees of files on top of each other, resulting in a single merged tree.


npm install --save-dev broccoli-merge-trees


var BroccoliMergeTrees = require('broccoli-merge-trees');

var mergedNode = new BroccoliMergeTrees(inputNodes, options);
  • inputNodes: An array of nodes, whose contents will be merged

  • options: A hash of options


  • overwrite: By default, broccoli-merge-trees throws an error when a file exists in multiple nodes. If you pass { overwrite: true }, the output will contain the version of the file as it exists in the last input node that contains it.

  • annotation: A note to help tell multiple plugin instances apart.


If this is your Brocfile.js:

var BroccoliMergeTrees = require('broccoli-merge-trees');

module.exports = new BroccoliMergeTrees(['public', 'scripts']);

And your project contains these files:

├─ public
│  ├─ index.html
│  └─ images
│     └─ logo.png
├─ scripts
│  └─ app.js
├─ Brocfile.js

Then running broccoli build the-output will generate this folder:

├─ app.js
├─ index.html
└─ images
   └─ logo.png

The parent folders, public and scripts in this case, are not included in the output. The output tree contains only the files within each folder, all mixed together.


Clone this repo and run the tests like so:

npm install
npm test

Issues and pull requests are welcome. If you change code, be sure to re-run npm test. Oftentimes it's useful to add or update tests as well.