📱 expo-brownfield

expo-brownfield provides a toolkit and APIs for integrating Expo into existing native applications.

API Documentation

You can find the API documentation for the beta release in the Expo documentation.

Installation in managed Expo projects

For managed Expo projects, please follow the installation instructions in the API documentation for the beta release.

Installation in bare React Native projects

For bare React Native projects, you must ensure that you have installed and configured the expo package before continuing.

Config plugin

Ensure that you have the expo-brownfield plugin included in your app.json or app.config.js file. You can pass additional configurations (such as iOS target name or Android library name) via the plugin options. If no extra options are added, defaults will be used.

{
  "plugins": ["expo-brownfield"]
}

{
  "plugins": [
    [
      "expo-brownfield",
      {
        "ios": {
          "targetName": "MyBrownfield"
        },
        "android": {
          "library": "mybrownfield"
        }
      }
    ]
  ]
}

Configure for Android and iOS

Run npx expo prebuild after adding the plugin to your app.json file to generate the additional native targets for brownfield.

For projects that don't use CNG please follow the manual steps at How to add Expo to an existing native (brownfield) app.

Contributing

Contributions are very welcome! Please refer to guidelines described in the contributing guide.