app.plugin.js missing at package root in v2 RC, expo prebuild fails with plugin resolution error

[tan5166]

Library Version

@use-voltra/ios-client@2.0.0-rc.2 / @use-voltra/android-client@2.0.0-rc.2

React Native Version

0.85.3

React Version

19.2.3

Expo Version

56.0.5

Minimal Reproduction

No dedicated repo needed, reproducible with a fresh Expo project:

Steps:

1. Create a new Expo project:

   npx create-expo-app my-app
   cd my-app

2. Install Voltra v2 RC:

   npm install @use-voltra/ios-client@2.0.0-rc.2 @use-voltra/android-client@2.0.0-rc.2

3. Add the plugins to app.json:

   {
     "expo": {
       "plugins": [
         ["@use-voltra/ios-client", { "widgets": [] }],
         ["@use-voltra/android-client", { "widgets": [] }]
       ]
     }
   }

4. Run prebuild:

   npx expo prebuild --clean

Result:

No "app.plugin.{js,cjs,mjs,ts,cts,mts}" file was found in "@use-voltra/ios-client",
loaded the package's main entry instead.

PluginError: Cannot find module '../native/VoltraRNNativeComponent'
Require stack:
  - node_modules/@use-voltra/ios-client/build/commonjs/components/VoltraView.js
  - node_modules/@use-voltra/ios-client/build/commonjs/components/VoltraLiveActivityPreview.js
  - node_modules/@use-voltra/ios-client/build/commonjs/index.js
  ...

Root Cause
Expo's plugin resolver uses resolveFrom (filesystem-based), which does not consult package.json exports map. Since no physical app.plugin.js exists at the package root of either -client package, the fallback to main entry triggers the crash.

Additional Information (Optional)

No response

[Angelk90]

@tan5166 : I'm trying with a native project, without expo: npx @react-native-community/cli@latest init project

Do you know if it can work without being an expo project?

[franko-c]

looks like the exports map already points there but resolveFrom skips it — a root-level redirect should do it:

// packages/{ios,android}-client/app.plugin.js
module.exports = require('./expo-plugin/app.plugin.js');