react-native-coverage

Testing is the backpressure you need in this brave agentic future.
Coverage is the evidence so agents do not hand-wave past the testing.
You found the module for integrated native coverage proof on iOS and Android.

TurboModule flush → pull/export → LCOV/Jacoco reports → assert in CI.
Dedicated test / e2e harness apps only (Pattern C). New Architecture only.

Not for production product apps. Put this in your harness workspace, not the shipping package.json.

---

Have your agent wire it up

Paste this into your coding agent (Cursor, Claude, Codex, etc.) before you touch Gradle or Podfiles by hand:

Integrate react-native-coverage into this repo's dedicated React Native test /
e2e harness app only (Pattern C — never the production app package.json).

Constraints:
- New Architecture / TurboModule only
- Follow https://github.com/invertase/react-native-coverage and docs under docs/
- Prefer the Expo config plugin when the harness is Expo; otherwise use the bare
  Gradle + CocoaPods Ruby helpers from docs/integration/
- Wire libraryProjectMatchers / frameworkNamePrefixes for every native library
  we need hits from
- Add CI steps that pull coverage and fail with rn-coverage assert (or equivalent)
  when hits are empty (exit 2)
- Do not invent product-app install paths; keep the package out of the shipping app

After install: yarn/npm add react-native-coverage in the harness, apply plugin or
manual hooks, prebuild/pod install as needed, then show me the exact CI commands
to run and what green looks like.

Then install in the harness (not the product app):

yarn add react-native-coverage
# or: npm install react-native-coverage

Expo harness — add the plugin (see Android / iOS for options):

{
  "expo": {
    "plugins": [
      [
        "react-native-coverage",
        {
          "libraryProjectMatchers": ["my-native-lib"],
          "frameworkNamePrefixes": ["MyLib"],
          "enableAndroidCoverage": true,
          "forceDynamicFrameworks": false
        }
      ]
    ]
  }
}

npx expo prebuild

Bare RN: apply android/rn-coverage*.gradle and cocoapods/coverage_post_install.rb as documented. Copy react-native-coverage.config.js.example if you need host-specific paths.

Prove it in CI (empty hits must fail):

rn-coverage android pull && rn-coverage android report
rn-coverage ios pull && rn-coverage ios export && rn-coverage ios report
rn-coverage assert   # exit 2 when coverage is empty — that is the point

Full CLI surface: docs/cli.md.

---

What you get

Piece	Role
TurboModule	iOS LINKEDIT flush + Android Emma dump from the running app
CLI (rn-coverage)	android pull|report, ios pull|export|report|summary, assert
Expo config plugin	Gradle helpers + Podfile helper call (safe split)
CocoaPods Ruby helper	Pod LLVM flags + optional dynamic-framework restore
Gradle Jacoco helpers	android/rn-coverage.gradle + android/rn-coverage-jacoco.gradle

Docs: docs/ · Pattern C · Android · iOS · Config · Releasing

---

Example / CI cells

This repo's example/ (Expo) and example-dynamic/ (bare, dynamic frameworks) are the harness. Appium (WebDriverIO) on every PR:

Cell	Path	Notes
iOS dynamic (primary)	example-dynamic/	Non-zero fixture LCOV gate
iOS static	example/	Expo staticlib merge; fixture hits still asserted
Android	example/	Jacoco + Appium

yarn
yarn prepare
yarn test
yarn e2e:ios:dynamic
yarn e2e:ios:static
yarn e2e:android
node bin/rn-coverage.js --help

---

Releasing

Conventional Commits + semantic-release; manual workflow_dispatch only (no push-to-main publish). Operator steps: docs/releasing.md.

License

Apache-2.0