@ajaybhatia/react-native-meteor

Meteor-like methods for React Native.

What is it for ?

The purpose of this library is :

• To set up and maintain a ddp connection with a ddp server, freeing the developer from having to do it on their own.
• Be fully compatible with react-native and help react-native developers.
• To match with Meteor documentation used with React.

Install

yarn add @ajaybhatia/react-native-meteor

or

npm i --save @ajaybhatia/react-native-meteor

!! See detailed installation guide

Warning < RN 0.57.8 Android bug

There was a bug in the react native websocket android implementation that meant the close event wasn't being received from the server. Therefore RN versions prior to React-native 0.57.8 will not detect users being logged out from the server side. There could also be other bugs resulting from this.

Example usage (with withTracker)

import React from 'react';
import { View, Text, FlatList } from 'react-native';
import Meteor, { withTracker } from '@ajaybhatia/react-native-meteor';

Meteor.connect('ws://192.168.X.X:3000/websocket'); //do this only once

const App = ({ settings, todos, todosReady }) => {
  return (
    <View>
      <Text>{settings.title}</Text>
      {!todosReady && <Text>Not ready</Text>}

      <FlatList
        data={todos}
        keyExtractor={item => item._id}
        renderItem={({ item }) => <Text>{item.title}</Text>}
      />
    </View>
  );
};

export default withTracker(params => {
  const handle = Meteor.subscribe('todos');
  Meteor.subscribe('settings');

  return {
    todosReady: handle.ready(),
    todos: Meteor.collection('todos').find({}, { sort: { createdAt: -1 } }),
    settings: Meteor.collection('settings').findOne(),
  };
})(App);

Example usage (with useTracker hook)

import React from 'react';
import { View, Text, FlatList } from 'react-native';
import Meteor, { useTracker } from '@ajaybhatia/react-native-meteor';

Meteor.connect('ws://192.168.X.X:3000/websocket'); //do this only once

export default App = () => {
  const loading = useTracker(() => {
    const handle = Meteor.subscribe('todos');
    Meteor.subscribe('settings');

    return !handle.ready();
  }, []);

  const todos = useTracker(
    () => Meteor.collection('todos').find({}, { sort: { createdAt: -1 } }),
    [loading]
  );
  const settings = useTracker(() => Meteor.collection('settings').findOne(), [
    loading,
  ]);

  if (loading) {
    return (
      <View>
        <Text>Not ready</Text>
      </View>
    );
  }

  return (
    <View>
      {loading && <Text>Not ready</Text>}

      <FlatList
        data={todos}
        keyExtractor={item => item._id}
        renderItem={({ item }) => <Text>{item.title}</Text>}
      />
    </View>
  );
};

Documentation

• Learn how to getting started from connecting your components.
• The API reference lists all public APIs.
• Visit the How To ? section for further information.

Author

• Ajay Bhatia (@ajaybhatia)
• Théo Mathieu (@Mokto) from inProgress
• Nicolas Charpentier (@charpeni)

Want to help ?

Pull Requests and issues reported are welcome! :)

License

react-native-meteor is MIT Licensed.