Firebase Database is a popular NoSQL cloud database that allows developers realtime synchronization of live data. With multi-platform support, synchronizing data between users and clients is pretty seamless, but it can also be used more generally as a generic persistent NoSQL data backing if you don't care about realtime updates. It has a very flexible rules syntax to allow minute control over data access as well.
See firebase.google.com/docs/database for more general information.
Luckily, Firebase JavaScript SDK starting from version 3.1+ has almost full support for React Native, so adding it to our Exponent app is super easy. The one caveat covered later in this guide is that the user login components typically provided by the Firebase SDKs will not work for React Native, and thus we will have to work around it.
Here's the official Firebase blog post regarding the announcement: firebase-reactive-native
Note: This guide only covers Firebase Realtime Database, and not the other services under the larger Google Firebase umbrella.
First we need to setup a Firebase Account and create a new project. We will be using the JavaScript SDK provided by Firebase, so pull it into your Exponent project.
npm install --save firebase
.
The Firebase console will provide you with an api key, and other identifiers for your project needed for initialization. firebase-web-start has a detailed description of what each field means and where to find them in your console.
import ReactNative from "react-native";
import * as firebase from 'firebase';
// Initialize Firebase
const firebaseConfig = {
apiKey: "<YOUR-API-KEY>",
authDomain: "<YOUR-AUTH-DOMAIN>",
databaseURL: "<YOUR-DATABASE-URL>",
storageBucket: "<YOUR-STORAGE-BUCKET>"
};
firebase.initializeApp(firebaseConfig);
By default Firebase Database has a security rule setup such that all devices accessing your data must be authenticated. We obviously haven't setup any authentication yet, so we can disable it for now while we setup the rest of our app.
Go into the Firebase console for Database, and under the Rules tab you should see a default set of rules already provided for you. Change the rules to:
{
"rules": {
".read": true,
".write": true
}
}
See Sample Firebase Rules for good sets of rules for your data, including unauthenticated.
Note It is important to note that this is temporary for development, and these rules should be thoroughly assessed before releasing an application.
Storing data through Firebase can be pretty simple. Image we're creating a game where highscores are stored in Firebase for everyone to see. We could create a users bucket in our data that is referenced by each user. Setting their highscore would be straightforward.
function storeHighScore(userId, score) {
firebase.database().ref('users/' + userId).set({
highscore: score
});
}
Now let's say we wanted another client to listen to updates to the high score of a specific user. Firebase allows us to set a listener on a specific data reference and get notified each time there is an update to the data. In the example below, every time a highscore is updated for the given user, it will print it to console.
setupHighccoreListener(userId) {
firebase.database().ref('users/' + userId).on('value', function(snapshot) {
var highscore = snapshot.val().highscore;
console.log("New high score: " + highscore);
});
}
This was all pretty simple and works fairly out of the box for what Firebase JavaScript SDK provides. There is one caveat however. We skipped the authentication rules for simplicity at the beginning. Firebase SDKs provide authentication methods for developers, so they don't have to reimplement common login systems such as Google or Facebook login.
This includes UI elements in the Web, Android, and iOS SDK versions for Firebase, however, these UI components do not work with React Native and should not be called. Thankfully, Firebase gives us ways to authenticate our data access given that we provide user authentication ourselves.
We can choose different login methods that make sense to our application. The login method choice is orthogonal to the Firebase Database access, however, we do need to let Firebase know how we have setup our login system such that it can correctly assign authentication tokens that match our user accounts for data access control. You can use anything you want, roll your own custom login system, or even forego it altogether if all your users can have unrestricted access.
A common login system many developers opt for is a simple Facebook login that users are already familiar with. Exponent provides a great Facebook login component already, so we just need to plug that in.
See Facebook Component on how to set this up.
Once you have added Facebook login to your Exponent app, we need to adjust the Firebase console to check for it. Under the Authentication section in the console in the Sign-In Method tab, enable Facebook as a sign-in provider.
You can add whichever provider makes sense for you, or even add multiple providers. We will stick with Facebook for now since we already have a simple drop-in Exponent component already built.
We need to re-enable the Data Security Rule in our Firebase console again to check for user authentication. This time our rules will be slightly more complicated.
For our example, let's say we want everyone to be able to read the high score for any user, but we want to restrict writes to only the user who the score belongs to. You wouldn't want anyone overwriting your highscore, would you?
{
"rules": {
"users": {
"$uid": {
".read": true,
".write": "$uid === auth.uid"
}
}
}
}
We are now ready to connect the Facebook login code with our Firebase Database implementation.
firebase.initializeApp(config);
// Listen for authentication state to change.
firebase.auth().onAuthStateChanged(
function(user) {
if(user != null) {
console.log("We are authenticated now!");
}
...
});
...
async loginWithFacebook() {
const { type, token } = await Exponent.Facebook.logInWithReadPermissionsAsync(
'<APP_ID>', {
permissions: ['public_profile'],
});
if (type === 'success') {
// Build Firebase credential with the Facebook access token.
var credential = firebase.auth.FacebookAuthProvider.credential(token);
// Sign in with credential from the Facebook user.
firebase.auth().signInWithCredential(credential).catch(function(error) {
// Handle Errors here.
...
});
}
}
The Facebook login method is similar to what you see in the Facebook login guide, however,
the token we receive from a successful login can be passed to the Firebase SDK to provide
us with a Firebase credential via firebase.auth.FacebookAuthProvider.credential
.
We can then sign-in with this credential via firebase.auth().signInWithCredential
.
The firebase.auth().onAuthStateChanged
event allows us to set a listener when the authentication
state has changed, so in our case, when the Facebook credential is used to successfully sign in to
Firebase, we are given a user object that can be used for authenticated data access.
Now that we have a user object for our authenticated user, we can adapt our previous
storeHighScore()
method to use the uid of the user object as our user reference.
Since the user.uid
's are generated by Firebase automatically for authenticated users,
this is a good way to reference our users bucket.
function storeHighScore(user, score) {
if(user != null) {
firebase.database().ref('users/' + user.uid).set({
highscore: score
});
}
}