React_Native.md

Using StanzaJS with React Native

StanzaJS does work with React Native (through 0.60), but it requires a little bit of extra configuration to shim properly.

1. Add required dependencies to your package.json:

• node-libs-react-native
• vm-browserify
• react-native-randombytes

npm i --save node-libs-react-native vm-browserify react-native-randombytes

2. Configure metro.config.js to shim node libraries

Add a resolver section to the Metro config, specifying the extraNodeModules to use:

// metro.config.js

module.exports = {
    transformer: {
        getTransformOptions: async () => ({
            transform: {
                experimentalImportSupport: false,
                inlineRequires: false
            }
        })
    },
    resolver: {
        extraNodeModules: {
            ...require('node-libs-react-native'),
            vm: require.resolve('vm-browserify')
        }
    }
};

The vm module is not currently shimmed by node-libs-react-native (but there is a PR for it).

3. Link native modules

Linking modules depends on the version of React Native you are using.

Using React Native 0.60:

Install CocoaPods for your project:

cd ios && pod install;

Using React Native 0.59 and earlier:

Link the react-native-randombytes module:

react-native link

4. Add node globals shim:

Add an import for node-libs-react-native/globals:

// your top-level index.js

import 'node-libs-react-native/globals';

Done

Your app should now be able to load and use StanzaJS. If you are trying to use Jingle and WebRTC, you will need to also set up react-native-webrtc.