# react-popper

> Official library to use Popper on React projects

Latest version **2.3.0** (published 2022-04-28) · MIT license · 0 weekly downloads

## Install

```sh
npm install react-popper
pnpm add react-popper
yarn add react-popper
bun add react-popper
```

## Health

**Score 30/100 (F)** — status: abandoned.

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

Warnings: low downloads.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 2.3.0 |
| Published | 2022-04-28 |
| First published | 2016-10-07 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 2 |
| Unpacked size | 77.2 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 2485 |
| Author | Travis Arnold |
| Maintainers | fezvrasta, souporserious |
| Keywords | react, react-popper, popperjs, component, drop, tooltip, popover |

## Links

- npm: https://www.npmjs.com/package/react-popper
- Repository: https://github.com/popperjs/react-popper
- Homepage: https://popper.js.org/react-popper
- Issues: https://github.com/popperjs/react-popper/issues
- npm.io page: https://npm.io/package/react-popper

## Dependencies (2)

- [warning](https://npm.io/package/warning.md) ^4.0.2
- [react-fast-compare](https://npm.io/package/react-fast-compare.md) ^3.0.1

## 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

- 2.3.0 (latest) — 2022-04-28
- 1.3.11 (version-1.x) — 2021-03-04
- 2.2.5 — 2021-03-25
- 1.3.10 — 2021-02-23
- 1.3.9 — 2021-02-18
- 1.3.8 — 2021-02-16
- 2.2.4 — 2020-11-05
- 2.2.3 — 2020-04-28
- 2.2.2 — 2020-04-11
- 2.2.1 — 2020-04-10
- 2.2.0 — 2020-04-09
- 2.1.0 — 2020-04-06
- 2.0.0 — 2020-03-31
- 1.3.7 — 2019-12-09
- 1.3.6 — 2019-11-07
- … 57 more at https://npm.io/package/react-popper/versions

## README

# React Popper

[![Unit Tests](https://github.com/popperjs/react-popper/workflows/Unit%20Tests/badge.svg)](https://github.com/popperjs/react-popper/actions?query=workflow%3A%22Unit+Tests%22)
[![npm version](https://img.shields.io/npm/v/react-popper.svg)](https://www.npmjs.com/package/react-popper)
[![npm downloads](https://img.shields.io/npm/dm/react-popper.svg)](https://www.npmjs.com/package/react-popper)
[![Dependency Status](https://david-dm.org/souporserious/react-popper.svg)](https://david-dm.org/souporserious/react-popper)
[![code style: prettier](https://img.shields.io/badge/code_style-prettier-ff69b4.svg)](https://github.com/prettier/prettier)
[![Get support or discuss](https://img.shields.io/badge/chat-on_spectrum-6833F9.svg?logo=data%3Aimage%2Fsvg%2Bxml%3Bbase64%2CPHN2ZyBpZD0iTGl2ZWxsb18xIiBkYXRhLW5hbWU9IkxpdmVsbG8gMSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIiB2aWV3Qm94PSIwIDAgMTAgOCI%2BPGRlZnM%2BPHN0eWxlPi5jbHMtMXtmaWxsOiNmZmY7fTwvc3R5bGU%2BPC9kZWZzPjx0aXRsZT5zcGVjdHJ1bTwvdGl0bGU%2BPHBhdGggY2xhc3M9ImNscy0xIiBkPSJNNSwwQy40MiwwLDAsLjYzLDAsMy4zNGMwLDEuODQuMTksMi43MiwxLjc0LDMuMWgwVjcuNThhLjQ0LjQ0LDAsMCwwLC42OC4zNUw0LjM1LDYuNjlINWM0LjU4LDAsNS0uNjMsNS0zLjM1UzkuNTgsMCw1LDBaTTIuODMsNC4xOGEuNjMuNjMsMCwxLDEsLjY1LS42M0EuNjQuNjQsMCwwLDEsMi44Myw0LjE4Wk01LDQuMThhLjYzLjYzLDAsMSwxLC42NS0uNjNBLjY0LjY0LDAsMCwxLDUsNC4xOFptMi4xNywwYS42My42MywwLDEsMSwuNjUtLjYzQS42NC42NCwwLDAsMSw3LjE3LDQuMThaIi8%2BPC9zdmc%2B)](https://spectrum.chat/popper-js/react-popper)

React wrapper around [Popper](https://popper.js.org).

**important note:** Popper is **not** a tooltip library, it's a _positioning
engine_ to be used to build features such as (but not restricted to) tooltips.

## Install

Via package managers:

```bash
# With npm
npm i react-popper @popperjs/core

# With Yarn
yarn add react-popper @popperjs/core
```

**Note:** `@popperjs/core` must be installed in your project in order for
`react-popper` to work.

Via `script` tag (UMD library exposed as `ReactPopper`):

```html
<script src="https://unpkg.com/react-popper/dist/index.umd.js"></script>
```

## Documentation

The full documentation can be found on the official Popper website:

http://popper.js.org/react-popper


## Running Locally

#### clone repo

`git clone git@github.com:popperjs/react-popper.git`

#### move into folder

`cd ~/react-popper`

#### install dependencies

`npm install` or `yarn`

#### run dev mode

`npm run demo:dev` or `yarn demo:dev`

#### open your browser and visit:

`http://localhost:1234/`

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