nodenv-default-packages

A nodenv plugin that installs a set of npm packages every time you install a new version of Node.

This nodenv plugin hooks into the nodenv install command to automatically install npm packages every time you install a new version of Node. It requires the node-build plugin to be installed.

Forked from the excellent rbenv-default-gems plugin from sstephenson.

• Installation
  • Installing as a nodenv plugin
  • Installing with Homebrew (for macOS users)
• Usage
  • default-packages Files
  • Updating Default Packages
• Credits

Installation

Installing as a nodenv plugin

Make sure you have the latest nodenv and node-build versions, then run:

git clone https://github.com/nodenv/nodenv-default-packages.git $(nodenv root)/plugins/nodenv-default-packages

Installing with Homebrew (for macOS users)

MacOS users can install nodenv-default-packages with the Homebrew package manager.

This is the recommended method of installation if you installed nodenv with Homebrew.

brew install nodenv/nodenv/nodenv-default-packages

Or, if you would like to install the latest development release:

brew install --HEAD nodenv/nodenv/nodenv-default-packages

Usage

nodenv-default-packages automatically installs the packages listed in the default-packages file(s) file every time you successfully install a new version of Node with nodenv install.

Specify packages in default-packages by name, one per line. You may optionally specify a SemVer version spec after the name. For example:

grunt-cli
jshint ~2.6.3
csslint >= 0.9.0 < 0.10.0

Empty lines and lines beginning with a # are ignored.

default-packages Files

nodenv-default-packages reads from $(nodenv root)/default-packages as well as nodenv/default-packages under all XDG config directories. The XDG config directories searched are $XDG_CONFIG_HOME ($HOME/.config if unset/empty) and all colon-separated $XDG_CONFIG_DIRS (/etc/xdg if unset/empty).

Updating Default Packages

if you update your $(nodenv root)/default-packages and want to refresh some or all of your existing node installations you can use commands like this:

nodenv default-packages install 8.8.1   # Reinstall default packages on Node version 8.8.1

nodenv default-packages install --all   # Reinstall default packages on _all_ installed Node versions

Note

This may take some time.

Credits

Forked from Sam Stephenson's rbenv-default-gems by Josh Hagins and modified for nodenv.