Skip to content

A command-line tool for converting projects that use npm shrinkwrap to Yarn.

License

Notifications You must be signed in to change notification settings

mixmaxhq/npm2yarn

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

npm2yarn

A command-line tool for converting projects that use npm, npm-shrinkwrap (Uber's package for shrinkwrapping), and/or npm-shrinkwrap-check to Yarn.

npm2yarn was open-sourced as part of our Yarn-ifying Mixmax blog post, which goes into detail about why we decided to move to Yarn, how we did it, and what we learned along the way.

We created npm2yarn to ensure that we updated our projects correctly throughout our 75-project sweep of Yarnification.

Procedure

npm2yarn:

  1. Checks out the master branch
  2. Pulls the latest changes
  3. Checks out a new branch, yarnify, overwriting any existing yarnify branch
  4. Removes npm-shrinkwrap.json if it exists
  5. Uninstalls npm-shrinkwrap if it exists, updating package.json
  6. Uninstalls npm-shrinkwrap-check if it exists, updating package.json
  7. Removes node_modules to avoid any installation conflicts
  8. Installs your project dependencies using Yarn, generating a yarn.lock file
  9. Runs yarn check to ensure that your dependencies were installed correctly (check out our blog post if you encounter any issues in this step)
  10. Runs yarn test as a sanity check
  11. Stages the changes made
  12. Logs a list of manual steps to be taken to complete the transition

This conversion will likely involve the upgrading of some/many of your transitive dependencies, so make sure to test thoroughly! :)

Installation

$ yarn global add npm2yarn

or

$ npm install -g npm2yarn

Usage

Make sure you've installed Yarn.

(in the directory of the project to convert, which must be a Git repository)

$ npm2yarn

Troubleshooting

Check out our Yarn-ifying Mixmax blog post for details on the issues we came across while transitioning to Yarn and how we solved them.

If you're having trouble with the script, please file an issue and we'll check it out!

Contributing

We welcome your pull requests! Please lint your code.

Changelog

  • 1.0.0 Add initial code

About

A command-line tool for converting projects that use npm shrinkwrap to Yarn.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 3

  •  
  •  
  •