opencollective-postinstall

What is opencollective-postinstall?

The opencollective-postinstall npm package is designed to display a message after the installation of an npm package. This is typically used by open source projects to encourage users to support their work via Open Collective. It helps maintainers to promote their funding needs directly in the terminal after a user installs their package.

What are opencollective-postinstall's main functionalities?

Display a custom message post-installation

This feature allows package maintainers to display a custom message in the terminal after their package is installed. The message is usually a call to support the project on Open Collective. The code snippet shows how to set up the postinstall script in the package.json file to trigger the opencollective-postinstall command.

{
  "scripts": {
    "postinstall": "opencollective-postinstall"
  }
}

Other packages similar to opencollective-postinstall

funding

Similar to opencollective-postinstall, the 'funding' package is used to display a message about funding options for the package. However, 'funding' allows for more customization in terms of the message content and the funding platforms it supports, making it a more flexible option compared to opencollective-postinstall.

postinstall-postinstall

This package serves a similar purpose by allowing messages or scripts to be run after npm install. While opencollective-postinstall focuses specifically on Open Collective funding messages, postinstall-postinstall can be used for a variety of post-install scripts, not limited to funding appeals.

README

Open Collective postinstall

Lightweight npm postinstall message to invite people to donate to your collective

Installation

npm install --save opencollective-postinstall

And in your package.json add:

{
  ...
  "scripts": {
    "postinstall": "opencollective-postinstall"
  },
  "collective": {
    "url": "https://opencollective.com/webpack"
  }
  ...
}

Disabling this message

In some places (e.g. CI) you may want to disable this output. You can do this by setting the environment variable DISABLE_OPENCOLLECTIVE=true.

It will not be shown if npm's log level is set to silent (--silent), warn (--quiet), or error (--loglevel error).

Note: This is a lightweight alternative to the opencollective-cli that offers a more complete postinstall message with the current balance and ASCII logo of the collective.