# react-peer-data

> React wrapper for PeerData library for files, media streaming/sharing using WebRTC

Latest version **1.1.5** (published 2026-11-19) · MIT license · 0 weekly downloads

## Install

```sh
npm install react-peer-data
pnpm add react-peer-data
yarn add react-peer-data
bun add react-peer-data
```

## Health

**Score 70/100 (B)** — status: active.

Positive: has types; esm support; no vulnerabilities; recently updated; high maintenance score; high quality score.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 1.1.5 |
| Published | 2026-11-19 |
| First published | 2019-05-20 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 1 |
| Unpacked size | 44.1 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Author | Rafał Lorenz |
| Maintainers | vardius |
| Keywords | react hook, react-hook, use, webrtc, web, rtc, peer, peer2peer, react, usePeerData, useWebRtc, react-use-peer, react-use-webrtc, react-use-peerdata, react-peer-hook, react-peerdata-hook, react-webrtc-hook, use-peer, peer data, peerdata, usepeerdata hook, usewebrtc hook, react-hooks-peer-data, react-hooks-web-rtc, react usepeerdata, react usewebrtc, react hooks tutorial, react custom hooks, react-usepeerdata, react-usewebrtc, use hooks, react usepeerdata hook, react usewebrtc hook, react-hooks-peerdata, react-hooks-webrtc, react hooks usepeerdata, react hooks webrtc, use peer data hook, react peer data hook, react webrtc hook |

## Links

- npm: https://www.npmjs.com/package/react-peer-data
- Homepage: https://github.com/vardius/react-peer-data#readme
- Issues: https://github.com/vardius/react-peer-data/issues
- npm.io page: https://npm.io/package/react-peer-data

## Dependencies (1)

- [peer-data](https://npm.io/package/peer-data.md) ^3.2.4

## Alternatives

- [mobx-react](https://npm.io/package/mobx-react.md) — 2.8M weekly downloads
- [rc-tree](https://npm.io/package/rc-tree.md) — 2.6M weekly downloads
- [@react-oauth/google](https://npm.io/package/@react-oauth/google.md) — 1.3M weekly downloads
- [@wagmi/connectors](https://npm.io/package/@wagmi/connectors.md) — 877.0K weekly downloads
- [vee-validate](https://npm.io/package/vee-validate.md) — 836.4K weekly downloads

## Recent versions

- 1.1.5 (latest) — 2026-11-19
- 1.1.4 — 2020-05-24
- 1.1.3 — 2020-05-24
- 1.1.2 — 2020-05-24
- 1.1.1 — 2020-05-23
- 1.1.0 — 2020-05-23
- 1.0.8 — 2020-03-25
- 1.0.6 — 2020-03-25
- 1.0.5 — 2019-05-30
- 1.0.4 — 2019-05-30
- 1.0.3 — 2019-05-30
- 1.0.2 — 2019-05-30
- 1.0.1 — 2019-05-30
- 1.0.0 — 2019-05-21
- 0.1.6 — 2019-05-21
- … 6 more at https://npm.io/package/react-peer-data/versions

## README

React WebRTC - PeerData
================
[![Build Status](https://travis-ci.org/vardius/react-peer-data.svg?branch=master)](https://travis-ci.org/vardius/react-peer-data)
[![npm version](https://img.shields.io/npm/v/react-peer-data.svg)](https://www.npmjs.com/package/react-peer-data)
[![npm downloads](https://img.shields.io/npm/dm/react-peer-data.svg)](https://www.npmjs.com/package/react-peer-data)
[![license](https://img.shields.io/github/license/vardius/react-peer-data.svg)](LICENSE)
[![codecov](https://codecov.io/gh/vardius/react-peer-data/branch/master/graph/badge.svg)](https://codecov.io/gh/vardius/react-peer-data)

<details>
  <summary>Table of Content</summary>

<!-- toc -->
- [About](#about)
- [How to use](#how-to-use)
  - [Installation](#installation)
  - [Examples](#examples)
    - [Hook](#hook)
    - [HOC](#hoc)
- [License](#license)
<!-- tocstop -->

</details>

ABOUT
==================================================
React wrapper for PeerData library for files, media streaming/sharing using WebRTC.

Contributors:

* [Rafał Lorenz](http://rafallorenz.com)

Want to contribute ? Feel free to send pull requests!

Have problems, bugs, feature ideas?
We are using the github [issue tracker](https://github.com/vardius/react-peer-data/issues) to manage them.

<!-- ![Dashboard](../master/.github/kubernetes-dashboard-overview.png)
![Dashboard](../master/.github/kubernetes-dashboard-pods.png) -->

HOW TO USE
==================================================

1. [Chat Example](https://github.com/vardius/react-webrtc-chat)

## Getting started
### Installation
```bash
npm install react-peer-data
```
### Examples
Use `PeerDataProvider` to instantiate and pass peerData object down the component tree
```javascript
import React from 'react';
import ReactDOM from 'react-dom';
import { PeerDataProvider } from 'react-peer-data';

import App from './App';

ReactDOM.render(
    <PeerDataProvider
        servers={{ iceServers: [{ url: "stun:stun.1.google.com:19302" }] }}
        constraints={{ ordered: true }}
    >
        <App />
    </PeerDataProvider>,
    document.getElementById("root")
);
```
You can access peerData context value in two ways:
#### Hook
```javascript
import React, { useEffect } from 'react';
import { usePeerData } from 'react-peer-data';

function App() {
  const peerData = usePeerData();

  useEffect(() => {
      const stream = await navigator.mediaDevices.getUserMedia({ audio: true, video: true });
      const room = peerData.connect('my-room', stream);
      room
        .on("participant", participant => {
            participant
                .on("disconnected", () => { console.log('disconnected', participant.id); })
                .on("track", event => { console.log('stream', participant.id, event.streams[0]); })
                .on("message", payload => { console.log(participant.id, payload); })
                .on("error", event => {
                    console.error('peer', participant.id, event);
                    participant.renegotiate();
                });
        })
        .on("error", event => { console.error('room', name, event); });

      return () => room.disconnect()
  }, [peerData]);

  return null; // @TODO: render participants
}

export default App;
```
#### HOC
```javascript
import React from 'react';
import { withPeerData } from 'react-peer-data';

function App({ peerData }) {
  // follow example from above

  return null; // @TODO: render participants
}

export default withPeerData(App);
```

License
-------

This package is released under the MIT license. See the complete license in the package:

[LICENSE](LICENSE.md)

---
_Source: https://npm.io/package/react-peer-data · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
