Need help with think-piece?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

stevekinney
130 Stars 157 Forks 17 Commits 24 Opened issues

Description

A demostration application for working with Firebase and Cloud Firestore

Services available

!
?

Need anything else?

Contributors list

# 12,541
Electro...
C++
pwm
Chrome
10 commits
# 33,817
CSS
apollo-...
GraphQL
Express
2 commits

Firebase && React

Initial Set Up

  • Take a tour of the application.
  • Set up a new project in the Firebase console.
  • Take a tour of the Firebase console.
  • Go to the Database section and create a new Cloud Firestore.
    • Put it into test mode.

Installing Firebase in Your React Application

Let's make a new file called

firebase.js
.
import firebase from 'firebase/app';

const config = { apiKey: 'AIzaSyAudsj8rc2TsUjwUx1ISskz-FPwEYuYlCw', authDomain: 'think-piece.firebaseapp.com', databaseURL: 'https://think-piece.firebaseio.com', projectId: 'think-piece', storageBucket: 'think-piece.appspot.com', messagingSenderId: '98218894562', };

firebase.initializeApp(config);

export default firebase;

Explain the following:

  • The apiKey just associates you with a Firebase project. We don't need to hide it.
    • Your project will be protected by security rules later.
    • There is a second, more important key that we'll use later that should be hidden.
  • We're just pulling in
    firebase/app
    so that we don't end up pulling in more than we need in our client-side application.
  • We configure Firebase and then we'll export it for use in other places in our application.

Setting Up Cloud Firestore

This basic installation of firebase does not include Cloud Firestore. So, let's get that in place as well.

import firebase from 'firebase/app';
import 'firebase/firestore'; // NEW

const config = { apiKey: 'AIzaSyAudsj8rc2TsUjwUx1ISskz-FPwEYuYlCw', authDomain: 'think-piece.firebaseapp.com', databaseURL: 'https://think-piece.firebaseio.com', projectId: 'think-piece', storageBucket: 'think-piece.appspot.com', messagingSenderId: '98218894562', };

firebase.initializeApp(config);

export const firestore = firebase.firestore(); // NEW

export default firebase;

Cloud Firestore

Fetching Posts from Cloud Firestore

Let's start by fetching posts whenenver the

Application
component mounts.

First, let's pull in Cloud Firestore from our new

firebase.js
file.
import { firestore } from '../firebase';

Now, we'll get all of the posts from Cloud Firestore whenenver the

Application
component mounts.
componentDidMount = async () => {
  const posts = await firestore.collection('posts').get();

console.log(posts); }

Hmm… that looks like a

QuerySnapshot
not our posts. What is that?

QuerySnapshots

A

QuerySnapshot
has the following properties:
  • docs
    : All of the documents in the snapshot.
  • empty
    : This is a boolean that lets us know if the snapshot was empty.
  • metadata
    : Metadata about this snapshot, concerning its source and if it has local modifications.
    • Example:
      SnapshotMetadata {hasPendingWrites: false, fromCache: false}
  • query
    : A reference to the query that you fired.
  • size
    : The number of documents in the
    QuerySnapshot
    .

…and the following methods:

  • docChanges()
    : An array of the changes since the last snapshot.
  • forEach()
    : Iterates over the entire array of snapshots.
  • isEqual()
    : Let's you know if it matches another snapshot.

QuerySnapshots
typically hold onto a number
QueryDocumentSnapshot
s, which inherit from
DocumentSnapshot
and have the following properties:
  • id
    : The
    id
    of the given document.
  • exists
    : Is this even a thing in the database?
  • metadata
    : Pretty much the same as
    QuerySnapshot
    above.
  • ref
    : A reference to the the documents location in the database.

…and the following methods:

  • data()
    : Gets all of the fields of the object.
  • get()
    : Allows you to access a particular property on the object.
  • isEqual()
    : Useful for comparisons.

References allow you to access the database itself. This is useful for getting the collection that document is from, deleting the document, listening for changes, setting and updating properties.

Dealing With That Gnarly Error

You'll notice that we have a very mean error message at the top of our console. Cloud Firestore made an API change that we need to opt into. This is a new application, so that seems fine.

firestore.settings({ timestampsInSnapshots: true });

Now the error should be gone.

Iteraring Through Documents

So, now let's iterate through all zero of our documents.

componentDidMount = async () => {
  const snapshot = await firestore.collection('posts').get();

snapshot.forEach(doc => { const id = doc.id; const data = doc.data();

console.log({ id, data });

}); }

There won't be a lot to see here. Let's go into the Cloud Firestore console and create a document.

Now, we should see it in the console.

componentDidMount = async () => {
  const snapshot = await firestore.collection('posts').get();

const posts = snapshot.docs.map(doc => ({ id: doc.id, ...doc.data() }));

this.setState({ posts }); }

An aside, combining the document IDs with the data is something we're going to be doing a lot. Let's make a utility method in

utilities.js
:
export const collectIdsAndData = doc => ({ id: doc.id, ...doc.data() })

Now, we'll refactor that code as follows in

Application.js
:
componentDidMount = async () => {
    const snapshot = await firestore.collection('posts').get();

const posts = snapshot.docs.map(collectIdsAndData);

this.setState({ posts });

}

Now, we can rid of the those posts in state.

state = {
  posts: [],
};

Adding a New Post

First of all, we need to get rid of that

Date.now()
based
id
in
AddPost
. It was useful for us for a second or two there, but now have Firebase generating for us on our behalf.
handleCreate = async post => {
  const docRef = await firestore.collection('posts').add(post);
  const doc = await docRef.get();

const newPost = { id: doc.id, ...doc.data(), };

const { posts } = this.state; this.setState({ posts: [newPost, ...posts] }); };

Important: Get rid of the automatically generated date-based ID!

Removing a Post

In

Application.js
:
import React, { Component } from 'react';

import Posts from './Posts'; import { firestore } from '../firebase';

class Application extends Component { // …

handleRemove = async (id) => { // NEW const allPosts = this.state.posts;

const posts = allPosts.filter(post => id !== post.id);

this.setState({ posts });

};

render() { const { posts } = this.state;

return (
  <main classname="Application">
    <h1>Think Piece</h1>
    <posts posts="{posts}" oncreate="{this.handleCreate}" onremove="{this.handleRemove}" new></posts>
  </main>
);

} }

export default Application;

In

Posts.js
:
const Posts = ({ posts, onCreate, onRemove /* NEW */ }) => {
  return (
    
{posts.map(post => ( /* NEW */ ))}
); };

In

Post.js
:
 onRemove(id)}>Delete

Now, we need to actually remove it from the Firestore.

handleRemove = async (id) => { // NEW
  const allPosts = this.state.posts;

const posts = allPosts.filter(post => id !== post.id);

await firestore.doc(posts/${id}).delete();

this.setState({ posts }); };

Subscribing to Changes

Instead of managing data manually, you can also subscribe to changes in the database. Instead of a

.get()
on the collection. You'd go with
.onSnapshot()
.
import React, { Component } from 'react';

import Posts from './Posts'; import { firestore } from '../firebase';

class Application extends Component { state = { posts: [], };

unsubscribe = null; // NEW

componentDidMount = async () => { this.unsubscribe = firestore.collection('posts').onSnapshot(snapshot => { // NEW const posts = snapshot.docs.map(doc => ({ id: doc.id, ...doc.data() })); this.setState({ posts }); }); };

componentWillUnmount = () => { // NEW this.unsubscribe(); }

handleCreate = async post => { const docRef = await firestore.collection('posts').add(post); // const doc = await docRef.get();

// const newPost = {
//   id: doc.id,
//   ...doc.data(),
// };

// const { posts } = this.state;
// this.setState({ posts: [newPost, ...posts] });

};

handleRemove = async (id) => { // const allPosts = this.state.posts;

try {
  await firestore.collection('posts').doc(id).delete();
  // const posts = allPosts.filter(post =&gt; id !== post.id);
  // this.setState({ posts });
} catch (error) {
  console.error(error);
}

};

render() { // … } }

export default Application;

Refactoring

In

Post.jsx
:
 firestore.collection('posts').doc(id).delete()}>
  Delete

In

AddPost.js
:
handleSubmit = async event => {
  event.preventDefault();

const { title, content } = this.state;

const post = { title, content, user: { uid: '1111', displayName: 'Steve Kinney', email: '[email protected]', photoURL: 'http://placekitten.com/g/200/200', }, favorites: 0, comments: 0, createdAt: new Date(), }

firestore.collection('posts').add(post); // NEW

this.setState({ title: '', content: '' }); };

In

Application.jsx
:
  • Remove the
    handleCreate
    method completely.
  • Remove the
    handleRemove
    method completely.
  • Remove
    onCreate
    and
    onRemove
    from the
     component in the 
    render()
    method.

Getting the Ordering Right

this.unsubscribe = firestore.collection('posts').orderBy('createdAt', 'desc').onSnapshot(snapshot => { // NEW
  const posts = snapshot.docs.map(collectIdsAndData);
  this.setState({ posts });
});

Using Firestore's Timestamps

Remember when we calmed Firebase down about timestamps? Take a good hard look at the date of the new posts we're creating. Uh oh! Moment.js is choking on invalid dates. This is because we're getting special

Timestamp
objects back from Firebase. We need to convert these to dates.

In

Post.jsx
:
moment(createdAt.toDate()).calendar()

Exercise: Updating Documents

Let's implement a naive approach to updating documents in Cloud Firestore.

We have that "Star" button. When a user clicks the "Star" button, we should increment the Stars on a post. We'll eventually write a better implementation of this.

Solution

 {
    firestore
      .collection('posts')
      .doc(id)
      .update({ stars: stars + 1 });
  }}
>
  Star

Quick Refactoring

const postRef = firestore.doc(`posts/${id}`);

//…

postRef.update({ stars: stars + 1 })} >Star postRef.delete()}>Delete

Authentication

Right now, the application is wide open. If we pushed this to production, any user could do literally anything they wanted to our database. That's not good.

Let's implement authentication in our application.

First, let's head over to the dashboard and turn on some authentication. We'll be using two forms of authentication.

  • Email and password authentication
  • Google sign-in

Let's go an turn those on.

Wiring the Current User Up to Application State

Let's store the current user in the state of the

Application
component for now.
state = {
  posts: [],
  user: null
};

Cool.We have a

CurrentUser
,
SignIn
, and
SignUp
components ready to rock.

We're going to start with Google Sign-in because I can assume you have a Google account if you can create a Firebase application.

In

Application.jsx
:
render() {
  const { posts, user } = this.state;

return (

Think Piece

{user ? : }
); }

In

firebase.js
:
import 'firebase/auth';

// …

export const auth = firebase.auth(); export const provider = new firebase.auth.GoogleAuthProvider(); export const signInWithGoogle = () => auth.signInWithPopup(provider);

In

SignIn.jsx
:
Sign In With Google

Updating Based on Authentication State

In

Application.jsx
:
unsubscribeFromFirestore = null;
unsubscribeFromAuth = null;

componentDidMount = async () => { this.unsubscribeFromFirestore = firestore .collection('posts') .onSnapshot(snapshot => { const posts = snapshot.docs.map(collectIdsAndData); this.setState({ posts }); });

this.unsubscribeFromAuth = auth.onAuthStateChanged(user => { this.setState({ user }); }); };

componentWillUnmount = () => { this.unsubscribeFromFirestore(); this.unsubscribeFromAuth(); };

Exercise: Implement Sign Out

I'll add this to

firebase.js
:
export const signOut = () => auth.signOut();

This one is pretty simple. There is a method called

auth.signOut()
. Can you write it up to the "Sign Out" button?

Solution

In

CurrentUser.jsx
:
Sign Out

Showing the Right Component The First TIme

state = {
  posts: [],
  user: null,
  userLoaded: false
};
this.unsubscribeFromAuth = auth.onAuthStateChanged(user => {
  this.setState({ user, userLoaded: true });
});
render() {
  const { posts, user, userLoaded } = this.state;

const userInformation = user ? :

return (

Think Piece

{ userLoaded && userInformation }
); }

Security Rules

Up until now, everything has been wide open. That's not great. If we're going to push stuff out to production, we're going to need to start adding some security to our application.

Cloud Firestore rules always following this structure:

service cloud.firestore {
  match /databases/{database}/documents {
    // ...
  }
}

There is a nice query pattern for rules:

service cloud.firestore {
  match /databases/{database}/documents {
    match /posts/{postId} {
      allow read: if ;
      allow write: if ;
    }
  }
}

You can combine them into one:

service cloud.firestore {
  match /databases/{database}/documents {
    match /posts/{postId} {
      allow read, write: if ;
    }
  }
}

You can get a bit more granular if you'd like:

  • read
    • get
    • list
  • write
    • create
    • update
    • delete

You can nest rules to sub-collections:

service cloud.firestore {
  match /databases/{database}/documents {
    match /posts/{postId} {
      match /comments/{comment} {
        allow read, write: if ;
      }
    }
  }
}

If you want to go to an arbitrary depth, then you can do

{document=**}
.

Important: If multiple rules match, then the operation is allowed if any of them are true.

Practical Examples

Only read or write if you're logged in.

service cloud.firestore {
  match /databases/{database}/documents {
    // Allow the user to access documents in the "posts" collection
    // only if they are authenticated.
    match /posts/{postId} {
      allow read, write: if request.auth.uid != null;
    }
  }
}

Only read and write your own data:

service cloud.firestore {
  match /databases/{database}/documents {
    match /users/{userId} {
      allow read, update, delete: if request.auth.uid == userId;
      allow create: if request.auth.uid != null;
    }
  }
}

Validating Based on the Document

  • resource.data
    will have the fields on the document as it is stored in the database.
  • request.resource.data
    will have the incoming document. (Note: This is all you have if you're responding to document creation.)

Accessing Other Documents

  • exists(/databases/$(database)/documents/users/$(request.auth.uid))
    will verify that a document exists.
  • get(/databases/$(database)/documents/users/$(request.auth.uid)).data
    will get you the data of another document.

You can write JavaScript functions to make stuff easier if you want.

Tasting Notes

  • Security rules are all or nothing
  • You can limit the size of a query so that malicious users (or you after a big lunch) can't run expensive queries
    • allow list: if request.query.limit <= 10;

The Current Defaults

This is what we have by default:

service cloud.firestore {
  match /databases/{database}/documents {
    match /{document=**} {
      allow read, write;
    }
  }
}

Wide open for anyone and anything. Not cool.

Hit publish! Cool. Now things blow up.

Let's make it so that authenticated users can add posts.

Only Allowing Posts If Logged In

service cloud.firestore {
  match /databases/{database}/documents {
    match /posts/{postId} {
      allow read;
      allow write: if request.auth.uid != null;
    }
  }
}

Note: Now that this can fail, let's add some better error handling.

Okay, so now any logged in user can also delete any other user's posts…

Users Can Only Delete Their Own Posts

service cloud.firestore {
  match /databases/{database}/documents {
    match /posts/{postId} {
      allow read;
      allow create: if request.auth.uid != null;
      allow update, delete: if request.auth.uid == resource.data.user.uid;
    }
  }
}

That's better.

Exercise: Validating Data

Can you create a rule that insists on a title?

Solution

service cloud.firestore {
  match /databases/{database}/documents {
    match /posts/{postId} {
      allow read;
      allow create: if request.auth.uid != null && !request.resource.data.title;
      allow update, delete: if request.auth.uid == resource.data.user.uid;
    }
  }
}

Implementing Sign Up with Email Authentication

In

SignUp.jsx
:
handleSubmit = async event => {
  event.preventDefault();

const { email, password, displayName } = this.state;

try { const { user } = await auth.createUserWithEmailAndPassword( email, password, );

user.updateProfile({ displayName });

} catch (error) { alert(error); }

this.setState({ displayName: '', email: '', password: '' }); };

This has some problems:

  • The display name won't update immediately.
  • There is no
    photoURL
    because we didn't get one for free.
  • We may want to store other information beyond what we get from the use profile.

The solution? Create documents for user profiles in Cloud Firestore.

Storing User Information in Cloud Firestore

The information on the user object is great, but we're going to run into limitations real quick.

  • What if we want to let the user set a bio or something?
  • What we want to set admin permissions on the users?
  • What we we want to keep track of what posts that a user has favorited?

These are very reasonable possibilities, right?

The solution is super simple: We'll make documents based off of the user's

uid
in Cloud Firestore.

Let's give ourselves some of the infrastructure for this.

export const createUserDocument = async (user, additionalData) => {
  // If there is no user, let's not do this.
  if (!user) return;

// Get a reference to the location in the Firestore where the user // document may or may not exist. const userRef = firestore.doc(users/${user.uid});

// Go and fetch a document from that location. const snapshot = await userRef.get();

// If there isn't a document for that user. Let's use information // that we got from either Google or our sign up form. if (!snapshot.exists) { const { displayName, email, photoURL } = user; const createdAt = new Date(); try { await userRef.set({ displayName, email, photoURL, createdAt, ...additionalData, }); } catch (error) { console.error('Error creating user', console.error); } }

// Get the document and return it, since that's what we're // likely to want to do next. return getUserDocument(user.uid); };

export const getUserDocument = async uid => { if (!uid) return null; try { const userDocument = await firestore .collection('users') .doc(uid) .get();

return { uid, ...userDocument.data() };

} catch (error) { console.error('Error fetching user', error.message); } };

We're going to put this two places:

  • onAuthStateChanged
    in order to get our Google Sign Ups
  • In
    handleSubmit
    in
    SignUp
    because that's where we'll have that custom display name.

Updating Security Rules

match /users/{userId} {
    allow read;
    allow write: if request.auth.uid == userId;
}

Modern State Management in React with Firebase

We have a small bug. For our first-time email users, we'll still get null for their display name.

We could solve all of this by passing everything down from the

Application
component, but I feel like we might be able do a little better.

We could wrap everything in HOCs, but that might also end us up in a position where we make additional queries to Cloud Firestore. This isn't ideal, but it's probably not the biggest problem in the world.

We could use Redux or something, but that seems like overkill.

What if we used React's Context API?

PostsProvider

import React, { Component, createContext } from 'react';
import { firestore } from '../firebase';
import { collectIdsAndData } from '../utilities';

export const PostsContext = createContext();

class PostsProvider extends Component { state = { posts: [] };

unsubscribe = null;

componentDidMount = () => { this.unsubscribe = firestore.collection('posts').onSnapshot(snapshot => { const posts = snapshot.docs.map(collectIdsAndData); this.setState({ posts }); }); };

componentWillUnmount = () => { this.unsubscribe(); };

render() { const { posts } = this.state; const { children } = this.props;

return (
  <postscontext.provider value="{posts}">{children}</postscontext.provider>
);

} }

export default PostsProvider;

Hooking Up the Posts Provider

In

index.jsx
:
import PostsProvider from './contexts/PostsProvider';

render( , document.getElementById('root'), );

In

Posts.jsx
:
import React, { useContext } from 'react';
import Post from './Post';
import AddPost from './AddPost';
import { PostsContext } from '../contexts/PostsProvider';

const Posts = () => { // const posts = useContext(PostsContext);

return (

<postscontext.consumer> {posts => posts.map(post => )} </postscontext.consumer>
); };

export default Posts;

Using Hooks!

import React, { useContext } from 'react';
import Post from './Post';
import AddPost from './AddPost';
import { PostsContext } from '../contexts/PostsProvider';

const Posts = () => { const posts = useContext(PostsContext);

return (

{posts.map(post => )}
); };

export default Posts;

Exercise: User Provider

In

UserProvider.jsx
:
import React, { Component, createContext } from 'react';
import { auth, createUserDocument } from '../firebase';

export const UserContext = createContext({ user: null });

class UserProvider extends Component { state = { user: null };

componentDidMount = async () => { this.unsubscribeFromAuth = auth.onAuthStateChanged(async user => { if (user) { const userDocument = await createUserDocument(user); return this.setState({ user: userDocument.data() }); } this.setState({ user: null }); }); };

componentWillUnmount = () => { this.unsubscribeFromAuth(); };

render() { const { children } = this.props; const { user } = this.state;

return <usercontext.provider value="{user}">{children}</usercontext.provider>;

} }

export default UserProvider;

In

index.jsx
:
import React from 'react';
import { render } from 'react-dom';

import './index.scss';

import Application from './components/Application'; import PostsProvider from './contexts/PostsProvider'; import UserProvider from './contexts/UserProvider';

render( , document.getElementById('root'), );

In

UserDashboard.jsx
:
import React, { useContext } from 'react'
import { UserContext } from '../contexts/UserProvider';
import SignIn from './SignIn';
import CurrentUser from './CurrentUser';

const UserDashboard = () => { const user = useContext(UserContext);

return (

{user ? : }
) };

export default UserDashboard;

Cleaning Up the User Interface

Maybe let's stop showing stuff that the user can't do?

In

Posts.jsx
:
{user && }

In

Post.jsx
:
const belongsToCurrentUser = (currentUser, postAuthor) => {
  if (!currentUser) return false;
  return currentUser.uid === postAuthor.uid;
}

//…

belongsToCurrentUser(currentUser, user) && firestore .collection('posts') .doc(id) .delete() } > Delete

Note: If you punted on the loading state for user states earlier, now is a good time.\

Creating a User Profile Page

We'll make a very simple

UserProfilePage
:
class UserPfoile extends Component {
  render() {
    return (
      
I am the user profile page.
); } }

In

index.js
:
import { BrowserRouter as Router } from 'react-router-dom';

render( , document.getElementById('root'), );

In

Application.jsx
:
import React, { Component } from 'react';

import Posts from './Posts'; import Authentication from './Authenication';

import { Switch, Link, Route } from 'react-router-dom'; import UserProfile from './UserProfilePage';

class Application extends Component {

render() { return (

Think Piece

); } }

export default Application;

In

CurrentUser.jsx
:

{displayName}

Okay, let's draw the owl with the

UserProfile
page.
import React, { Component } from 'react';
import { auth, firestore } from '../firebase';

class UserProfile extends Component { state = { displayName: '' }; imageInput = null;

get uid() { return auth.currentUser.uid; }

get userRef() { return firestore.collection('users').doc(this.uid); }

handleChange = event => { const { name, value } = event.target; this.setState({ [name]: value }); };

handleSubmit = event => { event.preventDefault();

const { displayName } = this.state;

if (displayName) {
  this.userRef.update(this.state);
}

};

render() { const { displayName } = this.state;

return (
  <section classname="UserProfile">
    <form onsubmit="{this.handleSubmit}" classname="UpdateUser">
      <input type="text" name="displayName" value="{displayName}" placeholder="Display Name" onchange="{this.handleChange}">
      <input type="file" ref="{ref"> (this.imageInput = ref)} /&gt;
      <input classname="update" type="submit">
    </form>
  </section>
);

} }

export default UserProfile;

Storage

So, what if the user wants to upload a new profile picture? We should facilitate that, right?

Firebase also includes storage as well.

Let's add storage to

firebase.js
:
import 'firebase/storage';

Cool, we'll export that as well.

export const storage = firebase.storage();

Wiring Up the File Upload

Back in

UserProfile.jsx
:
imageInput = null;

get file() { return this.imageInput && this.imageInput.files[0]; }

if (this.file) {
  storage
    .ref()
    .child('user-profiles')
    .child(this.uid)
    .child(this.file.name)
    .put(this.file)
    .then(response => response.ref.getDownloadURL())
    .then(photoURL => this.userRef.update({ photoURL }));
}

Setting Security Rules on the Bucket

You can get really excited, but it's going to blow up.

service firebase.storage {
  match /b/{bucket}/o {
    match /user-profile/{userId}/{photoURL} {
      allow read, write: if request.auth.uid == userId;
    }
  }
}

Working with Sub-collections

Let's create a page for a single post where people can leave comments.

import React, { Component } from 'react';

import { withRouter, Link, Redirect } from 'react-router-dom'; import Post from './Post'; import Comments from './Comments'; import { firestore } from '../firebase'; import { collectIdsAndData } from '../utilities';

class PostPage extends Component { state = { post: null, comments: [], loaded: false };

get postId() { return this.props.match.params.id; }

get postRef() { return firestore.doc(/posts/${this.postId}); }

get commentsRef() { return this.postRef.collection('comments'); }

unsubscribeFromPost = []; unsubscribeFromComments = [];

componentDidMount = async () => { this.unsubscribeFromPost = this.postRef.onSnapshot(snapshot => { const post = collectIdsAndData(snapshot); this.setState({ post, loaded: true }); });

this.unsubscribeFromComments = this.commentsRef.onSnapshot(snapshot =&gt; {
  const comments = snapshot.docs.map(collectIdsAndData);
  this.setState({ comments });
});

};

componentWillUnmount = () => { this.unsubscribeFromPost(); this.unsubscribeFromComments(); };

createComment = (comment, user) => { this.commentsRef.add({ ...comment, user, }); };

render() { const { post, comments, loaded } = this.state;

if (!loaded) return <p>Loading…</p>;

return (
  <section>
    {post &amp;&amp; <post></post>}
    <comments comments="{comments}" postid="{post.id}" oncreate="{this.createComment}"></comments>
    <footer>
      <link to="/">← Back
    </footer>
  </section>
);

} }

export default withRouter(PostPage);

Using the Higher Order Component Patter

Now, the comment button doesn't work just yet. We could pass stuff all of the way down, but we've decided that's cross. Let's try another pattern for size.

Remember,

withRouter
? That was pretty cool. Let's maybe try it with our user object.

In

withUser.jsx
:
import React from 'react';
import { UserContext } from '../contexts/UserProvider';

function getDisplayName(WrappedComponent) { return WrappedComponent.displayName || WrappedComponent.name || 'Component'; }

const withUser = Component => {

const WrappedComponent = props => ( <usercontext.consumer> {user => } </usercontext.consumer> ); WrappedComponent.displayName = WithUser(${getDisplayName(WrappedComponent)}); return WrappedComponent; }; export default withUser;

Now, we can use

withRouter
and
withUser
to get everything we need to our components.
handleSubmit = event => {
  event.preventDefault();


const { user } = this.props.user; const { id: postId } = this.props.match.params;

firestore.collection(posts/${postId}/comments).add({ ...this.state, user });

this.setState({ content: '' }); };

Hosting

Make sure you have the latest version of the Firebase CLI tools.

firebase install -g firebase-tools

(This will also do the trick if you don't have them at all.)

You'll also need to be logged in.

firebase login

You'll need to initialize your project.

firebase init

We'll pick the services we want to use and go with the defaults.

Note: Notice how it pulled down our security rules for Firestore and Storage. This means we can actually edit this stuff locally, which is pretty cool.

Note: You want to make sure that you're "public" directory is

build
and not
public
.

There is one setting where we do not want the default option:

? Configure as a single-page app (rewrite all urls to /index.html)? Yes

We'll modify our npm scripts to run our

build
script followed by
firebase deploy
.

In

package.json
:
"deploy": "npm run build && firebase deploy"

Cool! Now it should be online.

If you messed up any of the settings, then you should be able to play with them in

firebase.json
.

Production Logs and Rolling Back

If we head over to our project console, we can see each deploy that we've done.

The cool thing to notice here that that you can rollback to previous deploys if necessary.

Other than that, there is not a lot to see here.

Functions

Make sure you have the latest versions of the helper libraries installed.

npm install [email protected] [email protected] --save

Getting Started

Let's start by just uncommenting the example that it's

functions/index.js
.
const functions = require('firebase-functions');

// // Create and Deploy Your First Cloud Functions // // https://firebase.google.com/docs/functions/write-firebase-functions // exports.helloWorld = functions.https.onRequest((request, response) => { response.send("Hello from Firebase!"); });

Very cool. Let's go ahead and deploy that function and see how it goes.

firebase deploy --only functions

Okay, let's go visit that on the web.

https://us-central1-MY_PROJECT.cloudfunctions.net/helloWorld

Neat. Your API endpoint should world. You can

curl
it if you don't believe me.

Working with Cloud Firestore

Creating a Posts Endpoint

const admin = require('firebase-admin');
admin.initializeApp(functions.config().firebase);

const firestore = admin.firestore(); const settings = { timestampsInSnapshots: true }; firestore.settings(settings);

// ..

exports.getAllPosts = functions.https.onRequest(async (request, response) => { const snapshot = await admin .firestore() .collection('posts') .get(); const posts = snapshot.docs.map(doc => ({ id: doc.id, ...doc.data() }));

response.json({ posts }); });

This will fail for the stupidest reason.

async
is not supported in Node 6.

You have two options: rewrite this for promises or use the Node 8 engine.

Let's go with the latter.

Running Functions Locally

Deploying your functions every time can get tedious. Luckily, we can spin up a server to help us test our functions locally.

Listening for Cloud Firestore Triggers

We can also listen for events on documents in Firebase and automatically trigger functions.

Let's try to increment the comment count whenever we find ourselves making a comment.

exports.incrementCommentCount = functions.firestore
  .document('posts/{postId}/comments/{commentId}')
  .onCreate(async (snapshot, context) => {
    const { postId } = context.params;
    const postRef = firestore.doc(`posts/${postId}`);

const comments = await postRef.get('comments');
return postRef.update({ comments: comments + 1 });

});

Exercise: Decrementing Comments

Can you implement decrementing the comment count?

(Note: We don't have a way to delete comments in the UI. You can either do this in Firebase console—or you can just implement the user interface!)

exports.incrementCommentCount = functions.firestore
  .document('posts/{postId}/comments/{commentId}')
  .onCreate(async (snapshot, context) => {
    const { postId } = context.params;
    const postRef = firestore.doc(`posts/${postId}`);

const comments = await postRef.get('comments');
return postRef.update({ comments: comments + 1 });

});

Sanitize Content

exports.sanitizeContent = functions.firestore
  .document('posts/{postId}')
  .onWrite(async change => {
    if (!change.after.exists) return;

const { content, sanitized } = change.after.data();

if (content &amp;&amp; !sanitized) {
  return change.after.ref.update({
    content: content.replace(/CoffeeScript/g, '***'),
    sanitized: true,
  });
}

return null;

});

Updating User Information on a Post

exports.updateUserInformation = functions.firestore
  .document('users/{userId}')
  .onUpdate(async (snapshot, context) => {
    const { displayName } = snapshot.data();

const postsRef = firestore
  .collection('posts')
  .where('user.uid', '==', snapshot.id);

return postsRef.get(postSnaps =&gt; {
  postSnaps.forEach(doc =&gt; {
    doc.ref.update({ 'user.displayName': displayName });
  });
});

});

Bonus Content

Render Prop Pattern

import React, { Component } from 'react'
import { firestore } from '../firebase';
import { collectIdsAndData } from '../utilities';

class PostsForUser extends Component { state = { posts: [] };

unsubscribe = null;

componentDidMount = () => { const { uid } = this.props; this.unsubscribe = firestore.collection('posts').where('user.uid', '==', uid).orderBy('createdAt', 'desc').onSnapshot(snapshot => { const posts = snapshot.docs.map(collectIdsAndData); this.setState({ posts }); }); };

componentWillUnmount = () => { this.unsubscribe(); };

render() { return (

{this.props.children(this.state.posts)}
) } }

export default PostsForUser;

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.