ncmp

NCMP - NPM Client Modules Postprocessor

NCMP is a simple tool which allows you to perform some postprocessing after npm installs or updates. It is mainly designed for usage in client infrastructures. So if you use npm as your main client package manager.

Installation

npm install ncmp

Usage

The core feature is to copy files which are runtime dependencies of your client application to another folder structure outside of node_modules automatically.

You have to create a ncmp.json configuration file in the root folder of your project:

{
    "destinations": {
        "*": "scripts/components",
        "css": "content/components"
    },
    "packages": {
        "jquery": ["dist/jquery.js", "dist/jquery.min.js"]
    },
    "plugins": []
}

It defines the destination folders depending on the file extension. The base path is the root folder. In this example we want to copy the distributions from jquery. The tool will perform the following copy actions:

• ./node_modules/jquery/dist/jquery.js => ./scripts/components/jquery/jquery.js
• ./node_modules/jquery/dist/jquery.min.js => ./scripts/components/jquery/jquery.min.js

The folder with the name of the package stays present.

You can use globs everywhere in the source file paths:

dist/*.js
dist/jquery.*
dist/*.min.js

In the "plugins" array you can define a set of plugins which can do more specific postprocessing.

Plugins

• ncmp-systemjs-plugin

License

MIT