mirror of
https://github.com/zhigang1992/react-native-firebase.git
synced 2026-04-18 12:12:23 +08:00
115 lines
13 KiB
Markdown
115 lines
13 KiB
Markdown
<p align="center">
|
|
<a href="https://invertase.io/oss/react-native-firebase">
|
|
<img width="160px" src="https://i.imgur.com/JIyBtKW.png"><br/>
|
|
</a>
|
|
<h2 align="center">React Native Firebase</h2>
|
|
</p>
|
|
|
|
<p align="center">
|
|
<a href="https://www.npmjs.com/package/react-native-firebase"><img src="https://img.shields.io/npm/dm/react-native-firebase.svg?style=flat-square" alt="NPM downloads"></a>
|
|
<a href="https://www.npmjs.com/package/react-native-firebase"><img src="https://img.shields.io/npm/v/react-native-firebase.svg?style=flat-square" alt="NPM version"></a>
|
|
<a href="/LICENSE"><img src="https://img.shields.io/npm/l/react-native-firebase.svg?style=flat-square" alt="License"></a>
|
|
<a href="https://lerna.js.org/"><img src="https://img.shields.io/badge/maintained%20with-lerna-cc00ff.svg?style=flat-square" alt="Maintained with Lerna"></a>
|
|
</p>
|
|
|
|
<p align="center">
|
|
<a href="https://invertase.link/discord"><img src="https://img.shields.io/discord/295953187817521152.svg?style=flat-square&colorA=7289da&label=Chat%20on%20Discord" alt="Chat on Discord"></a>
|
|
<a href="https://twitter.com/rnfirebase"><img src="https://img.shields.io/twitter/follow/rnfirebase.svg?style=flat-square&colorA=1da1f2&colorB=&label=Follow%20on%20Twitter" alt="Follow on Twitter"></a>
|
|
</p>
|
|
|
|
---
|
|
|
|
> **WARNING**: Master branch is the work in progress v6.0.0 version of React Native Firebase, you're probably looking for the current [v5.x.x branch](https://github.com/invertase/react-native-firebase/tree/v5.x.x) instead, please send all PRs for the live version to that branch. You can [learn more about this here](https://invertase.io/blog/react-native-firebase-2019).
|
|
|
|
---
|
|
|
|
**React Native Firebase** is a collection of official React Native modules connecting you to Firebase services; each module is a light-weight javascript layer connecting you to the native Firebase SDKs for both iOS and Android.
|
|
|
|
React Native Firebase is built with four key principals in mind;
|
|
|
|
- 🧪 **Well tested**
|
|
- every module is extensively tested to >95% coverage
|
|
- 👁 **Well typed**
|
|
- first class support for both Flow & Typescript included
|
|
- 📄 **Well documented**
|
|
- full reference & installation documentation alongside detailed guides and FAQs
|
|
- 🔥 **Mirrors official Firebase Web SDK**
|
|
- functions as a drop-in replacement for the Firebase Web SDK in React Native
|
|
- maximises cross-platform code re-usability e.g. re-using code on web platforms
|
|
|
|
## Firebase Modules
|
|
|
|
This is the root of the monorepo for React Native Firebase, if you're looking for a specific package please select the package link from below.
|
|
|
|
The main package that you interface with is `App` (`@react-native-firebase/app`)
|
|
|
|
| Name | Downloads | Coverage |
|
|
| -------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------------------------------------------------------: |
|
|
| [AdMob](/packages/admob) | [](https://www.npmjs.com/package/@react-native-firebase/admob) | [](https://api.rnfirebase.io/coverage/admob/detail) |
|
|
| [Analytics](/packages/analytics) | [](https://www.npmjs.com/package/@react-native-firebase/analytics) | [](https://api.rnfirebase.io/coverage/analytics/detail) |
|
|
| [App](/packages/app) | [](https://www.npmjs.com/package/@react-native-firebase/app) | [](https://api.rnfirebase.io/coverage/app/detail) |
|
|
| [App Indexing](/packages/indexing) | [](https://www.npmjs.com/package/@react-native-firebase/indexing) | [](https://api.rnfirebase.io/coverage/indexing/detail) |
|
|
| [Authentication](/packages/auth) | [](https://www.npmjs.com/package/@react-native-firebase/auth) | [](https://api.rnfirebase.io/coverage/auth/detail) |
|
|
| [Cloud Firestore](/packages/firestore) | [](https://www.npmjs.com/package/@react-native-firebase/firestore) | [](https://api.rnfirebase.io/coverage/firestore/detail) |
|
|
| [Cloud Functions](/packages/functions) | [](https://www.npmjs.com/package/@react-native-firebase/functions) | [](https://api.rnfirebase.io/coverage/functions/detail) |
|
|
| [Cloud Messaging](/packages/messaging) | [](https://www.npmjs.com/package/@react-native-firebase/messaging) | [](https://api.rnfirebase.io/coverage/messaging/detail) |
|
|
| [Cloud Storage](/packages/storage) | [](https://www.npmjs.com/package/@react-native-firebase/storage) | [](https://api.rnfirebase.io/coverage/storage/detail) |
|
|
| [Crashlytics](/packages/crashlytics) | [](https://www.npmjs.com/package/@react-native-firebase/crashlytics) | [](https://api.rnfirebase.io/coverage/crashlytics/detail) |
|
|
| [Dynamic Links](/packages/dynamic-links) | [](https://www.npmjs.com/package/@react-native-firebase/dynamic-links) | [](https://api.rnfirebase.io/coverage/dynamic-links/detail) |
|
|
| [In-app Messaging](/packages/fiam) | [](https://www.npmjs.com/package/@react-native-firebase/fiam) | [](https://api.rnfirebase.io/coverage/fiam/detail) |
|
|
| [Instance ID](/packages/iid) | [](https://www.npmjs.com/package/@react-native-firebase/iid) | [](https://api.rnfirebase.io/coverage/iid/detail) |
|
|
| [ML Kit Natural Language](/packages/ml-natural-language) | [](https://www.npmjs.com/package/@react-native-firebase/ml-natural-language) | [](https://api.rnfirebase.io/coverage/ml-natural-language/detail) |
|
|
| [ML Kit Vision](/packages/ml-vision) | [](https://www.npmjs.com/package/@react-native-firebase/ml-vision) | [](https://api.rnfirebase.io/coverage/ml-vision/detail) |
|
|
| [Notifications](/packages/notifications) | [](https://www.npmjs.com/package/@react-native-firebase/notifications) | [](https://api.rnfirebase.io/coverage/notifications/detail) |
|
|
| [Performance Monitoring](/packages/perf) | [](https://www.npmjs.com/package/@react-native-firebase/perf) | [](https://api.rnfirebase.io/coverage/perf/detail) |
|
|
| [Realtime Database](/packages/database) | [](https://www.npmjs.com/package/@react-native-firebase/database) | [](https://api.rnfirebase.io/coverage/database/detail) |
|
|
| [Remote Config](/packages/config) | [](https://www.npmjs.com/package/@react-native-firebase/config) | [](https://api.rnfirebase.io/coverage/config/detail) |
|
|
| [Utils](/packages/utils) | [](https://www.npmjs.com/package/@react-native-firebase/utils) | [](https://api.rnfirebase.io/coverage/utils/detail) |
|
|
|
|
## Other Packages
|
|
|
|
React Native Firebase also publishes other packages.
|
|
|
|
| Name | Description |
|
|
| -------------------------------- | :---------------------------------------------: |
|
|
| [common](/packages/common) | Common utilities used by all modules. |
|
|
|
|
|
|
## Documentation
|
|
|
|
- [Overview](https://invertase.io/oss/react-native-firebase)
|
|
- [Quick Start](https://invertase.io/oss/react-native-firebase/quick-start)
|
|
- [Guides](https://invertase.io/oss/react-native-firebase/guides)
|
|
- [Modules](https://invertase.io/oss/react-native-firebase/v6)
|
|
|
|
## Contributing
|
|
|
|
- [Overview](https://invertase.io/oss/react-native-firebase/contributing)
|
|
- [Issues & PRs](https://invertase.io/oss/react-native-firebase/contributing/issues-prs)
|
|
- [Documentation](https://invertase.io/oss/react-native-firebase/contributing/documentation)
|
|
- [Code & Testing](https://invertase.io/oss/react-native-firebase/contributing/code-testing)
|
|
- [Marketing & Content](https://invertase.io/oss/react-native-firebase/contributing/marketing-content)
|
|
- [Community](https://invertase.io/oss/react-native-firebase/contributing/community)
|
|
- [Donating](https://invertase.io/oss/react-native-firebase/contributing/donating)
|
|
- [Code of Conduct](/CODE_OF_CONDUCT.md)
|
|
|
|
## License
|
|
|
|
- See [LICENSE](/LICENSE)
|
|
|
|
---
|
|
|
|
<p>
|
|
<img align="left" width="75px" src="https://static.invertase.io/assets/invertase-logo-small.png">
|
|
<p align="left">
|
|
Built and maintained with 💛 by <a href="https://invertase.io">Invertase</a>.
|
|
</p>
|
|
<p align="left">
|
|
<a href="https://invertase.io/hire-us">💼 Hire Us</a> |
|
|
<a href="https://opencollective.com/react-native-firebase">☕️ Sponsor Us</a> |
|
|
<a href="https://opencollective.com/jobs">💻 Work With Us</a>
|
|
</p>
|
|
</p>
|
|
|
|
---
|