Cache npm install results by hashing dependencies


npm-pkgr caches npm install results by hashing dependencies from package.json and npm-shrinkwrap.json.

If your package.json did not change from last build, then you will immediately get either:

  • a symlink node_modules..
  • a full node_modules copy..

.. to the latest build result located in ~/.npm-pkgr

npm-pkgr frees your deployments from npm network issues and will make your deploys run fast.

npm install -g npm-pkgr

Use npm-pkgr instead of npm install and you are done.


Hashes and find the latest build corresponding to package.json and npm-shrinkwrap.json.

npm-pkgr --production

Hashes and fin the latest build corresponding to npm-shrinkwrap.json.

Every flag passed to npm-pkgr is then passed down to npm command.

The cache folder used by npm-pkgr is ~/.npm-pkgr for current user.

npm-pkgr prune

Removes older than a month cache folders (into your ~/.npm-pkgr folder)

DEBUG=npm-pkgr* npm-pkgr

Will give you some debug information.

Default strategy is to symlink $CWD/node_modules -> ~/.npm-pkgr/$hash/node_modules.

You can also get a full copy of the ~/.npm-pkgr/$hash/node_modules.

npm-pkgr --strategy=copy

Carefull, if you --strategy copy, you will end up installing the copy package

  • insanely fast npm install if already done
  • npm install once in your CI server, deploy everywhere
  • solves shrinkwrap inconsistencies/problems
  • solves devDependencies updates even when you use a shrinkwrap
  • concurrent builds
  • get symlinks or copy to cached node_modules