Detect potential file system conflicts and if necessary prompt the user before overwriting files.

Downloads in past


420.1.98 years ago8 years agoMinified + gzip package size for base-fs-conflicts in KB


base-fs-conflicts NPM version NPM downloads Build Status
Detect potential file system conflicts and if necessary prompt the user before overwriting files.


Install with npm:
$ npm install --save base-fs-conflicts


Some of the logic in this plugin, in particular lib/diffs.js, is based on the conflicter code in yeoman-generator, Copyright (c) 2015, Google, licensed under BSD-2-Clause.


The following code should work with any base application, including verb, assemble, and generate.
var path = require('path');
var Base = require('base');
var fs = require('base-fs');
var conflicts = require('base-fs-conflicts');
var base = new Base();

// register the `conflicts` and `fs` plugins

// pass the same `dest` to both `.dest()` and `.conflicts()`
var dest = 'fixtures/dist';

  .pipe(base.conflicts(dest)) // adds a `.conflicts()` method

If a file conflict is detected, you'll see something like this in the terminal:
screen shot 2016-03-17 at 8 05 53 pm


  1. The existing file's contents is compared with file.contents on the vinyl file
  2. If the contents of both are identical, no action is taken
  3. If the contents differ, the user is prompted for action
  4. If no conflicting file exists, the vinyl file is written to the file system

  • dest {String}: The same desination directory passed to app.dest()
  • returns {String}


Related projects

You might also be interested in these projects:
  • assemble: Get the rocks out of your socks! Assemble makes you fast at creating web projects… more | homepage
  • generate: Command line tool and developer framework for scaffolding out new GitHub projects. Generate offers the… more | homepage
  • templates: System for creating and managing template collections, and rendering templates with any node.js template engine… more | homepage
  • verb: Documentation generator for GitHub projects. Verb is extremely powerful, easy to use, and is used… more | homepage


This document was generated by verb-readme-generator (a verb generator), please don't edit directly. Any changes to the readme must be made in See Building Docs.
Pull requests and stars are always welcome. For bugs and feature requests, please create an issue. Or visit the verb-readme-generator project to submit bug reports or pull requests for the readme layout template.

Building docs

Generate readme and API documentation with verb:
$ npm install -g verb verb-readme-generator && verb

Running tests

Install dev dependencies:
$ npm install -d && npm test


Jon Schlinkert


Copyright © 2016, Jon Schlinkert. Released under the MIT license.

This file was generated by verb
, v0.9.0, on July 26, 2016.