50 lines
2.3 KiB
Markdown
50 lines
2.3 KiB
Markdown
|
# React Native Firebase
|
||
|
|
|
||
|
|
RNFirebase makes using the latest [Firebase](http://firebase.com) with React Native straight-forward.
|
||
|
|
|
||
|
|
```
|
||
|
|
npm i react-native-firebase --save
|
||
|
|
```
|
||
|
|
|
||
|
|
[](https://gitter.im/invertase/react-native-firebase?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge)
|
||
|
|
[](https://www.npmjs.com/package/react-native-firebase)
|
||
|
|
[](/LICENSE)
|
||
|
|
|
||
|
|
RNFirebase is a _light-weight_ layer sitting on-top of the native Firebase libraries for both iOS and Android which mirrors the React Native JS api as closely as possible.
|
||
|
|
|
||
|
|
Featuring; authentication, storage, real-time database, presence, analytics, cloud messaging, remote configuration, redux support and more!
|
||
|
|
|
||
|
|
## RNFirebase vs Firebase JS lib
|
||
|
|
|
||
|
|
Although the [Firebase](https://www.npmjs.com/package/firebase) JavaScript library will work with React Native, it is mainly designed for the web.
|
||
|
|
|
||
|
|
The native SDK's are much better for performance compared to the web SDK. The web SDK will run on the same thread as your apps ([JS thread](https://facebook.github.io/react-native/docs/performance.html#javascript-frame-rate)) therefore limiting your JS framerate, potentially affecting things touch events and transitions/animations.
|
||
|
|
|
||
|
|
The native SDK's also contains functionality that the web SDK's do not, for example [Analytics](/docs/api/analytics.md) and [Remote Config](/docs/api/remote-config.md).
|
||
|
|
|
||
|
|
## Example app
|
||
|
|
|
||
|
|
We have a working application example available in at [invertase/firebase-app](https://github.com/invertase/firebase-app). Check it out for more details about how to use firebase with react native.
|
||
|
|
|
||
|
|
## Documentation
|
||
|
|
|
||
|
|
* Installation
|
||
|
|
* [iOS](docs/installation.ios.md)
|
||
|
|
* [Android](docs/installation.android.md)
|
||
|
|
* [Firebase Setup](docs/firebase-setup.md)
|
||
|
|
* API
|
||
|
|
* [Authentication](docs/api/authentication.md)
|
||
|
|
* [Analytics](docs/api/analytics.md)
|
||
|
|
* [Storage](docs/api/storage.md)
|
||
|
|
* [Realtime Database](docs/api/database.md)
|
||
|
|
* [Presence](docs/api/presence.md)
|
||
|
|
* [ServerValue](docs/api/server-value.md)
|
||
|
|
* [Cloud Messaging](docs/api/cloud-messaging.md)
|
||
|
|
* [Remote Config](docs/api/remote-config.md)
|
||
|
|
* [Events](docs/api/events.md)
|
||
|
|
* [Redux](docs/redux.md)
|
||
|
|
|
||
|
|
## Contributing
|
||
|
|
|
||
|
|
- TODO
|