node package manager
Share your code. npm Orgs help your team discover, share, and reuse code. Create a free org »



Communicate over ad hoc wifi using Multipeer Connectivity.

Known Issues

Below is a list of known issues. Pull requests are welcome for any of these issues!

  • No support for streams in React Native, so streaming is currently unavailable.
  • No support for resource transfers: I want this to work seamlessly with other file resources for other uses, so I'm waiting for those specs to be finalized.

Getting started

  1. npm install react-native-multipeer@latest --save
  2. In XCode, in the project navigator, right click LibrariesAdd Files to [your project's name]
  3. Go to node_modulesreact-native-multipeer and add RCTMultipeerConnectivity.xcodeproj
  4. In XCode, in the project navigator, select your project. Add libRCTMultipeerConnectivity.a to your project's Build PhasesLink Binary With Libraries
  5. Click RCTMultipeerConnectivity.xcodeproj in the project navigator and go the Build Settings tab. Make sure 'All' is toggled on (instead of 'Basic'). Look for Header Search Paths and make sure it contains both $(SRCROOT)/../react-native/React and $(SRCROOT)/../../React - mark both as recursive.
  6. Run your project (Cmd+R)


All you need is to require the react-native-multipeer module and then you can start using the singleton instance.

var React = require('react-native');
var {
} = React;
var MultipeerConnectivity = require('react-native-multipeer');
function getStateFromSources() {
  var ds = new ListView.DataSource({rowHasChanged: (r1, r2) => r1 !== r2});
    return {
      dataSource: ds.cloneWithRows(_.values(MultipeerConnectivity.getAllPeers()))
var peerApp = React.createClass({
  getInitialState: function() {
    return getStateFromSources()
  componentDidMount() {
    MultipeerConnectivity.on('peerFound', this._onChange());
    MultipeerConnectivity.on('peerLost', this._onChange());
    MultipeerConnectivity.on('invite', ((event) => {
      // Automatically accept invitations, true);
    MultipeerConnectivity.on('peerConnected', (event) => {
      alert( + ' connected!');
    MultipeerConnectivity.advertise('channel1', { name: 'User-' + Math.round(1e6 * Math.random()) });
  renderRow(peer) {
    return (
      <TouchableHighlight onPress={this.invite.bind(this, peer)} style={styles.row}>
  render: function() {
    return (
      <View style={styles.container}>
  _invite(peer) {
  _onChange() {
var styles = StyleSheet.create({
  container: {
    flex: 1,
    justifyContent: 'center',
    alignItems: 'center',
    backgroundColor: 'transparent',
  welcome: {
    fontSize: 20,
    textAlign: 'center',
    margin: 10,
  instructions: {
    textAlign: 'center',
    color: '#333333',
AppRegistry.registerComponent('peerApp', () => peerApp);

MultipeerConnectivity methods


advertise(channelId, info)

Allow discovery of yourself as a peer in a given channel. channelId can be any string. info is an object containing data which will be passed to other peers when you join the channel.


Browse for peers on a given channel.


Gets all the peers in the current channel.



Gets all the peers in the current session.


Disconnect from the current session.

invite(peerId [, callback])

Invite a peer from your channel into your session.

rsvp(inviteId, accept [, callback])

Accept/decline a session invitation.


broadcast(data [, callback<err>])

Send data to all connected peers in the current channel.

send(data, recipients [, callback<err>])

Send data to specific peers in the current channel. recipients is an array of peer IDs or Peers.

MultipeerConnectivity Events

MultipeerConnectivity inherits from EventEmitter - as such the .on method is available for listening to important events. Below is a list of those events.


Event properties: Peer sender, data

Fired when new data is received from sender.


Event properties: peer

A new peer was found in the current channel.


Event properties: peer

A peer left the current channel.


Event properties: peer

A peer has connected to your session.


Event properties: peer

A peer is connecting to your session.


Event properties: peer

A peer disconnected from your session.


Event properties: sender, invite

You have been invited to a session.

Peer methods



The peer connected to the current session.


The peer is connecting to the current session.


The peer disconnected from the current session.


The peer left the current channel.


These are some features I think would be important/beneficial to have included with this module. Pull requests welcome!

  • Stream support
  • Resource transfers