Meteor React Native

A set of packages allowing you to connect your React Native app to your Meteor server, and take advantage of Meteor-specific features like accounts, reactive data trackers, etc. Compatible with the latest version of React Native.

Full API Documentation

If you're new to React Native, you can view a guide to using React Native with Meteor on the Official Meteor Guide

Installation

1. npm install --save @meteorrn/core
2. Confirm you have peer dependencty @react-native-community/netinfo installed
3. Confirm you have @react-native-async-storage/async-storage@>=1.8.1 installed. If you are using Expo, or otherwise cannot use @react-native-async-storage/async-storage, see Custom Storage Adapter below.

A note on AsyncStorage

This package uses @react-native-async-storage/async-storage by default. This may cause issues if you are using certain React Native versions, or if you are using Expo. To use a custom AsyncStorage implementation, pass it as an option in Meteor.connect:

import { AsyncStorage } from 'react-native';

// ...

Meteor.connect("wss://myapp.meteor.com/websocket", { AsyncStorage });

If you are using the AsyncStorage API yourself, its important that you use the same version that MeteorRN is using, or issues could be caused due to the conflicting versions. Make sure you are using the same AsyncStorage you pass into Meteor (or @react-native-async-storage/async-storage if you aren't passing anything), or you can use MeteorRN's package interface.

Basic Usage

import Meteor, { Mongo, withTracker } from '@meteorrn/core';

// "mycol" should match the name of the collection on your meteor server, or pass null for a local collection
let MyCol = new Mongo.Collection("mycol");

Meteor.connect("wss://myapp.meteor.com/websocket"); // Note the /websocket after your URL 

class App extends React.Component {
    render() {
        let {myThing} = this.props;
        
        return (
            <View>
                <Text>Here is the thing: {myThing.name}</Text>
            </View>
        );
    } 
}

let AppContainer = withTracker(() => {
    Meteor.subscribe("myThing");
    let myThing = MyCol.findOne();
    
    return {
        myThing
    };
})(App)

export default AppContainer;

Companion Packages

The @meteorrn/core package has been kept as light as possible. To access more features, you can use companion packages.

Companion packages are NPM packages that are made specifically to extend MeteorRN. And since Atmosphere isn't available in React Native, MeteorRN uses companion packages that contain the client-side/relevant code from a Meteor package to allow your MeteorRN app to use the same package API as your Meteor app.

Native Feature Packages:

• @meteorrn/local(Beta): Package for storing of data locally that works seamlessly with MeteorRN by injecting data into a local minimongo collection

Atmosphere Packages:

• @meteorrn/ndev-mfa(Beta): Package that allows your RN app to work with meteor/ndev:mfa

Planned/Upcoming Packages:

• @meteorrn/queued-calls: Package that allows you to queue Meteor calls that will be performed when internet/server is available

If you have an idea for a companion package, please open an issue. If you would like to publish your own companion package, we recommend a package name with the prefix mrn-.

Compatibility

This package is compatible with React Native versions from 0.60.0 to latest (0.63.2)

For React Native <0.60.0 use react-native-meteor.

Migrating from react-native-meteor:

• cursoredFind is no longer an option. All .find() calls will return cursors (to match Meteor)
• MeteorListView & MeteorComplexListView have been removed
• CollectionFS has been removed
• createContainer has been removed
• Mixins (connectMeteor) have been removed
• composeWithTracker has been removed

Using on Web

While this package was designed with React Native in mind, it is also capable of running on web (using react-dom). This can be useful if you need a light-weight Meteor implementation, if you want to create a client app separate from your server codebase, etc. The only change required is providing an AsyncStorage implementation. Here is a simple example:

const AsyncStorage = {
    setItem:async (key, value) => window.localStorage.setItem(key, value),
    getItem:async (key) => window.localStorage.getItem(key)
    removeItem:async (key) => window.localStorage.removeItem(key)    
}

Meteor.connect("wss://.../websock", {AsyncStorage});

Changelog

The GitHub Releases Tab includes a full changelog

Package Interface

To ensure that MeteorRN companion packages use the same versions of external packages like AsyncStorage as the core, @meteorrn/core provides a package interface, where companion packages can access certain packages. Currently package interface returns an object with the following properties:

• AsyncStorage

Usage

import Meteor from '@meteorrn/core';

const {AsyncStorage} = Meteor.packageInterface();

Differences from Meteor Core to Note:

• This API does not implement observeChanges (but it does implement observe)

Showcase

Whazzup.co	StarlingRealtime
Whazzup.co uses Meteor React Native in their native app	StarlingRealtime uses Meteor React Native in their production app

---

Meteor React Native is maintained by Nathaniel Dsouza who is available for consultation: nate@hiyllo.com