👷‍♂️ Set of CLIs to scaffold and build React Native libraries for different targets.

• Documentation
• Development workflow
• Publishing
• Acknowledgements
• Alternatives
• License

Documentation is available at https://callstack.github.io/react-native-builder-bob/.

This project uses a monorepo using yarn. To setup the project, run yarn in the root directory to install the required dependencies.

yarn 

While developing, you can run watch mode to automatically rebuild the changes:

yarn watch 

To test the CLI locally, you can point to the appropriate executable:

../bob/packages/create-react-native-library/bin/create-react-native-library 

Before sending a pull request, make sure your code passes TypeScript and ESLint. Run the following to verify:

yarn typecheck yarn lint 

To fix formatting errors, run the following:

yarn lint --fix 

The documentation for the project is under docs directory. To run the documentation locally, run the following:

yarn docs dev 

Maintainers with write access to the GitHub repo and the npm organization can publish new versions. To publish a new version, first, you need to export a GH_TOKEN environment variable as mentioned here. Then run:

yarn lerna publish 

This will automatically bump the version and publish the packages. It'll also publish the changelogs on GitHub for each package.

When releasing a pre-release version, we need to:

• Update lerna.json to set the preId (e.g. next) and preDistTag (e.g. next) fields, and potentially the allowBranch field.
• Run the following command:

yarn lerna publish --conventional-commits --conventional-prerelease --preid next 

When releasing a stable version, we need to:

• Remove the preId and preDistTag fields from lerna.json.
• Run the following command:

yarn lerna publish --conventional-commits --conventional-graduate 

Thanks to the authors of these libraries for inspiration:

• create-react-native-module
• react-native-webview
• RNNewArchitectureLibraries

Some other tools for building React Native libraries that you may want to check out:

• create-expo-module
• react-native-module-init (Unmaintained)

MIT