Nerfing Powerful Megalomaniacs
Join us to discuss the challenges, solutions and best practices for in-house JavaScript code sharing. Tuesday, 12/17 at 10am PT/1pm ET.Sign up here »


2.2.0 • Public • Published


Workaround for using symlinks in React Native.

oclif Version Downloads/week License


Install the module globally.

npm install -g react-native-yunolink

and execute it in the root of a repository where you want to use the targetted Node.JS module(s). It supports multiple targets by separating each path with a whitespace. In addition this will temporarily update the watchFolders property in metro.config.js to force Metro bundler to also watch your targetted modules.

rn-link [...targets]
rn-link ../myModule1 ../myModule2

Or alternatively install the module as devDependency.

npm install -D react-native-yunolink

And watch and copy the module from your package.json by adding a scripts command.

  "watch-modules": "rn-link ../myModule1 ../myModule2"

Run it with npm run watch-myModule.


The CLI only has a single command available to start the module sync. If you need to ignore additional files or folders pass a comma separated list to -i or --ignore. Ensure you always provide [...targets] to rn-link.

If you want metro bundler to watch the linked folder for file changes and rebuild automatically, provide the -w flag. Watching files is only possible if the symlinked folder has no duplicate modules in node_modules.

In addition, -v and -h are available for version description and help.

Module tree

This module operates under the assumption npm or yarn dedupe node_modules to the root of your app. The node_modules of the synced target will be excluded. This will prevent @ProvidesModule errors in metro bundler.



npm i react-native-yunolink

DownloadsWeekly Downloads






Unpacked Size

8.81 kB

Total Files


Last publish


  • avatar