Skip to content
master
Switch branches/tags
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
bin
 
 
src
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Manage Linked Packages

List and reset NPM and Yarn global linked packages, manually or programmatically in Yarn/NPM scripts.

There is no out-of-the-box way to locate or reset packages that have been linked with NPM link or Yarn link.

Contents

Use-case example

  • Image you are developing a local package (PackageA) and you want another local package you are developing (PackageB) to use it, without having to publish packages in development to NPM/GitHub, then you use yarn link or npm link to create a global linked package
  • yarn link and npm link won't let you create/override a global linked package, say, if you needed to change folders where PackageA is located, or have a duplicate folder (for valid reasons). You have to yarn unlink or npm unlink PackageA first manually
  • You have to remember the location of PackageA, which can get difficult on machines with large number of projects

manage-linked-packages helps you to manage these packages manually or programmatically in Yarn/NPM scripts.

Install

With NPM:

npm install -g manage-linked-packages

With Yarn:

yarn global add manage-linked-packages

Usage

In your terminal or NPM/Yarn script type:

manage-linked-packages [options]

Options:

Short Syntax Long Syntax Description
-m <package-manager> --package-manager <package-manager> required: package manager to manage (yarn or npm)
-a <manage-action> --manage-action <manage-action> required: manage action to take (locate or reset)
-n <package-name> --package-name <package-name> required: name of global linked yarn/npm package to manage
-V --version output the version number
-h, --help output usage information

Examples

To locate the Yarn global linked package called some-package:

manage-linked-packages -m yarn -a locate -n some-package

This returns a success message with the real path of the linked package, for example:

found: /Users/user1/Projects/some-package

To reset the NPM global linked package called some-package:

manage-linked-packages -m npm -a reset -n some-package

This returns the output of the yarn unlink or npm unlink command that is performed in the appropriate global folder.

Uninstall

With NPM:

npm uninstall -g manage-linked-packages

With Yarn:

yarn global remove manage-linked-packages

About

List and reset NPM and Yarn global linked packages, manually or programmatically in Yarn/NPM scripts.

Topics

Resources

License

Packages

No packages published