Lernaman NPM | npm.io

lernaman

Manager for arranging/managing lerna-based packages under your app project.

Why?

React-native's metro builder really doesn't like working with peer directories. So the easiest way to get benefit from managing your JS modules is to use a lerna-managed monorepo, and then link those packages to your app in a parent/ancestor directory.

Basically,it makes JS development for nontrivial React-native much much easier.

Installation

This is easier than manual work, but it still has some steps:

Make a lerna-based repository with the code you want to use. (for example https://github.com/me/modules)
Make an app using react-native init or create-react-native-app
Switch to your app directory
yarn add lernaman
yarn run lernaman add https://github.com/me/modules --update
Set your "root" component to be one of your modules - using the pakage name. (I like to use react-native-set-root for this, eg react-native-set-root @rhdeck/rootmodule)
yarn start
Oops! Discover your missing dependencies (probably defined as peerDependencies in your module) and yarn add them.
'yarn start' again, and watch everything just work

Rehydration

Later, when you have committed your app then pull it down somewhere later, after your initial git clone and yarn install steps, run yarn run lernaman init --update to get your lerna packages deployed into your app. That's all there is to it!

Usage

lernaman --help

Get listing of commands. Useful.

lernaman add name --update

lernaman init name

Initialize lerna package name that is specified in package.json by copying/cloning into the appropriate directory. If --update is passed, the functionality of lernaman update [name] gets applied subsequently.

If name is not supplied, it will run the link process for all.

lernaman update name

NPM/Yarn isntall an initialized lerna package [name], bootstrap it, and run the "build" script defined within. Will automatically run the lernaman link functionality immediately after.

If name is not supplied, it will run the link process for all.

lernaman link name

Deploy symbolic links from the packages managed at lernas/[name] to your immediate node_modules directory. No bootstrap or other build process is applied.

If name is not supplied, it will run the link process for all.

lernaman remove

Remove the package at lernas/[name]. The package itself is recursively removed and the entry in package.json is eliminated to prevent future re-hydration.