Skip to content

zone-native/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 v4 of React Firebase Hooks which makes the package compatible with Firebase v9 and drops support for previous versions of Firebase - more details 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?

There has been a lot of hype around React Hooks, but this hype merely reflects that there are obvious real world benefits of Hooks to React developers everywhere.

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 v3 to v4

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

Documentation

License

Packages

No packages published

Languages

  • TypeScript 93.6%
  • JavaScript 6.4%