Prerequisites:
- GitHub account (having bash set up and knowing a few basic .git commands in terminal will come in handy!)
- Firebase account
- Node.js installed (Optional: Install yarn as well, if you don't already have it. I will be using yarn mostly in this project.)
Firebase tools globally installed:
npm i --global firebase-tools
oryarn global add firebase-tools
. Don't forget to addsudo
if your on mac or Linux when installing packages globally. - We should also have serve installed so we can run our build folder on a local server. More on why later, to install serve globally simply use:
npm i --global serve
oryarn global add serve
.
About this tutorial:
Firebase is an incredible platform to connect any iOS, android and/or web app too. By connecting your project to Google's Firebase you will have access to their cloud storage, cloud firestore and real time database, authentication, analytics and much more.
Firebase handles all of our hosting and back end needs in on place that is incredibly easy to use, once you know how. In this tutorial we are going to cover only how to deploy a react app to Firebase. I am going to use the create-react-app we've hosted in the next tutorial on how to set up user authentication with Firebase using hooks and redux so stay tuned for that!
Let's get started!
Step 1:
Let's start by creating a new project on GitHub!
Now lets name our project, and we can give it a description and an MIT license if we want to. I did not give it a README or a .gitignore because CRA will give us both of those things.
Now that our project has been created on GitHub lets copy that HTTPS or SSH (which ever you use) link and clone it to our computer!
Once we've cloned our project in the directory we want to use, before we cd inside of that directory we can run create-react-app <name-of-your-project>
and it will run CRA inside of the repo we just cloned as long as we name it the same as the cloned repo when we run CRA. Now we have our CRA in the root and can cd inside our project directory and yarn start
. Note: If you want to use npm, then delete your yarn.lock file so that you don't have a yarn.lock AND a package-lock.json file in the same project. This can lead to issues, however, I personally recommend sticking with yarn.
Set 2:
Now that we have our project setup in GitHub and cloned to our computer lets set up our project in Firebase! Go to firebase.google.com and create a project.
Name your project.
Google analytics is enabled by default, we might want to use it later so let's leave it that way.
Let's just select "Default Account for Firebase" option for now.
Congratulations, you now have a Firebase project!
Step 3:
Now that we have our GitHub repo created and cloned to our computer and we've created our project on firebase it's time to connect the two together and get our React app out there for the world to see! Let's take a dive in our terminal and set things up! In our project's root directory lets run firebase login
and select yes when it asks up to allow Firebase to collect information.
After selecting 'yes' it will open our browser and ask which google account we want to use to sign in. Select the account we used to create our Firebase project.
Now let's allow Firebase CLI to use our Google account:
And, wallah!!! We are now logged into Firebase and can use our Firebase account in our terminal.
Set 4:
Now it's time to create a build folder that will be the source we want Firebase to look at when it deploys our web app. To do this simply run yarn build
or npm run-scripts build
Then we can run serve -s build
. This will run our build folder on a local server. The build folder will only update every time you run yarn build
or npm run-scripts build
. You could go into your build folder and manually edit it, however I would not recommend doing that.
When we deploy our app on firebase we want to deploy what's in our build folder, so it's a good idea to spin it up on a local server and make sure everything looks and works right. Once you have verified that the build was successful you could ctrl/cmd + c
to stop the server inside our server and we can move on to the next step...
Step 5:
It's time to initialize firebase in our app! The command is firebase init
. It will ask you which Firebase CLI features you want to set up. Use the down arrow key to highlight Hosting and then press the space-bar to select. Once you've selected Hosting, hit enter/return to continue.
Now select Use an existing project
.
Now let's select that project we created on Firebase earlier, we only have one project created, and we see that's the only option here.
It's now asking us what we want to user as our public directory. We want to type in build
here so that we are hosting what we've built to our build folder.
Our project will be a single page React app so, we are going to want to say y for yes when it ask's us how we want to configure our app.
Then it's going to ask us if we want to overwrite our build/index.html. Let's give this a big fat N for NO WAY! If we say yes, Firebase will overwrite that file with Firebase's own boilerplate index.html and we will see that instead of our site. If you do accidentally say yes here then all you have to do is run yarn build
or npm run-scripts build
again to overwrite Firebase's index.html and get our site back up and view-able again.
And wallah!!! Firebase is initialized and it is time to...
Step 6:
Deploy!!!
Type firebase deploy
into the terminal and Firebase will deploy your site and give you back a hosting URL that you can go to and see your site live on the internet for the world to see! Congratulations, friend. We made it!
Thanks for following along with me this far. I'm going to use this project as the base for my next Firebase tutorial where we will go over authentication and Redux using hooks, so be sure to subscribe and stay tuned! Cheers