Skip to content

CSFrequency/react-firebase-hooks

Repository files navigation

React Firebase Hooks

A set of reusable React Hooks for Firebase.

npm version npm downloads

This documentation is for v5 of React Firebase Hooks which requires Firebase v9 or higher.

  • For v4 documentation (Firebase v9), see here.
  • For v3 documentation (Firebase v8), see here.
  • For v2 documentation, see here.

Installation

React Firebase Hooks v4 requires React 16.8.0 or later and Firebase v9.0.0 or later.

Whilst previous versions of React Firebase Hooks had some support for React Native Firebase, the underlying changes to v9 of the Firebase Web library have meant this is no longer as straightforward. We will investigate if this is possible in another way as part of a future release.

# with npm
npm install --save react-firebase-hooks

# with yarn
yarn add react-firebase-hooks

This assumes that you’re using the npm or yarn package managers with a module bundler like Webpack or Browserify to consume CommonJS modules.

Why?

This library explores how React Hooks can work to make integration with Firebase even more straightforward than it already is. It takes inspiration for naming from RxFire and is based on an internal library that we had been using in a number of apps prior to the release of React Hooks. The implementation with hooks is 10x simpler than our previous implementation.

Upgrading from v4 to v5

To upgrade your project from v4 to v5 check out the Release Notes which have full details of everything that needs to be changed.

Documentation

License