mcpField
R
rnrepo

rnrepo

github.com/software-mansion-labsDevelopment2961.1k installsUpdated 2w ago
Repository

About rnrepo

rnrepo is a setup and troubleshooting skill for using Software Mansion’s RNRepo to consume prebuilt React Native library artifacts. It guides developers through Expo CNG or standard React Native configuration, opt-outs, and build issues.

Key features

  1. 01Expo CNG and standard React Native setup
  2. 02Android Gradle and iOS CocoaPods configuration
  3. 03Per-library and global opt-outs
  4. 04Build troubleshooting guidance

Use cases

  1. 01Configure RNRepo in a React Native project
  2. 02Exclude a library with native patches
  3. 03Investigate prebuilt artifact build failures

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/software-mansion-labs/skills --skill rnrepo

After installing, type/rnrepoin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

references/
configuration.md
installation.md
troubleshooting.md

Details

From the project README

RNRepo

Software Mansion's infrastructure for pre-building and distributing React Native library artifacts, reducing native build times by up to 2× with zero infrastructure changes.

Read the relevant reference for the topic at hand. All references are in references/.

Key facts

  • Beta, New Architecture only. Works with React Native latest patches of 0.77, 0.78, 0.79 and all versions above 0.80.0.
  • How it works: A Gradle plugin (Android) and CocoaPods plugin (iOS) intercept the build and substitute libraries with prebuilt artifacts from packages.rnrepo.org. Falls back to source if a prebuild is unavailable.
  • Expo CNG: Use @rnrepo/expo-config-plugin — it configures both Android and iOS automatically.
  • Standard RN: Install @rnrepo/build-tools and edit android/build.gradle, android/app/build.gradle, and ios/Podfile manually.
  • Opt out per library: Add a rnrepo.config.json with a denyList at the project root. Required for libraries with native patches (Objective-C/Java/Kotlin). JS-only patches do NOT require opting out.
  • Opt out entirely: Set DISABLE_RNREPO=1 environment variable before the build command.

References

FileWhen to read
references/installation.mdSetting up RNRepo for the first time — Expo CNG, standard React Native, Android Gradle, iOS CocoaPods
references/configuration.mdOpting out specific libraries (denyList), disabling the plugin, Fingerprint config, GPG verification
references/troubleshooting.mdBuild failures, C++ debug/release mismatch, duplicate .so files, Xcode version issues, empty repository list, verifying the plugin works

Comments

Markdown supported