(re)install-node-modules

Have you ever been in the situation you were facing an issue that was simply caused by not having (re)installed node modules after someone had changed it?

Are you tired of telling people to (re)install their node modules when they ask you why something is not working?

This lightweight, zero-dependency package might be the perfect solution for you! It (re)installs node modules whenever the target package file has changed!

Installation

Install the package with your favorite manager

npm install reinstall-node-modules --save-dev

yarn add reinstall-node-modules --dev

Usage

You may use it in the scripts field of your package.json

{
  "scripts": {
    "reinstall": "reinstall-node-modules"
  }
}

However it's highly recommended to use a git hook to run it! There's no other way to make sure everybody has the correct node modules!

Hook

If you wanna use a hook for this it's recommended to use post-merge. An easy way to use git hooks is the husky package what would require to add the following to your package.json

{
  "husky": {
    "hooks": {
      "post-merge": "reinstall-node-modules"
    }
  }
}

Import

It's also possible import the package and use it programmatically though most of the time an npm-script or hook makes more sense.

const installer = require('reinstall-node-modules');
const options = {};

installer(options);

Options

manager

The manager option defines the package manager that gets used to (re)install the node modules. By default it's npm but you can use whatever you like (as long as it supports the install command).

If you wanna e.g. use yarn instead of npm you only need to pass it as option

reinstall-node-modules --manager yarn

file

The file option defines the path to the target package file that gets used to determine whether it's necessary to (re)install node modules or not (based on its content). You can use either a relative or an absolute path here. By default it's package.json assuming there's such a file in your current working directory.

If you wanna e.g. use package-lock.json instead of package.json you only need to pass it as option

reinstall-node-modules --file package-lock.json

Credits

This package is inspired by install-changed.

Last but not least, if this package is helpful to you it'll be great when you give me a star on github and share it. Keeps me motivated to continue the development.