Build an Application in a group of 2 or 3 that solves a problem you have using React and Firebase. Feel free to use any 3rd-party libraries and Firebase features beyond the ones we have learnt. In this project we are utilising Firebase a rudimentary backend and as a database.
This project must be a Frontend React Application that utilises React as well as Firebase products, including Realtime Database, Storage, and Authentication.
- The user interface of the Application is consistently styled across all components and screens
- The Application is accessible on various devices and screen sizes
- The Application is intuitive, usable and easy to navigate
- Application has been styled with superb custom CSS, React Bootstrap, MUI or another component UI or CSS framework
- The core functionalities of the application work as intended and expected
- The Application handles props effectively across components
- The Application manages and updates state effectively
- Interactivity:
- The Application contains at least 1 input that captures user input to alter Application state
- The Application contains at least 1 call to action that alters Applications state
- The Application can reflected updated state in the UI
- Complexity:
- Application has at least 2 levels of components eg:
App component and 1 or more child components - Application demonstrates the capability to lift up state
- Application has at least 2 levels of components eg:
- Application is required to persist data utilising Firebase Realtime Database (or an alternative like Firebase Firestore)
- Application must able to store files utilising Firebase Storage
- Application must contain an authentication system that leverages Firebase Authentication
- Application must contain multiple pages this can be implemented with React Router
- Application must contain at least 1 request to an external API using Axios or Fetch
- Application is organised as well as structured, it follows practices of component separation and has a good folder structure
- The code is easy to comprehend and read
- The Application contains meaningful variable and function names
- Application contains components that can be reused
- The Application preforms well without unwarranted rendering
- The Application's code follows consistent coding conventions, regarding indentations and formatting
- The Application follows the correct naming, casing and commenting best practices
- Application has been deployed with Firebase Hosting
- Git repository contains commits for each feature with descriptive commit messages
- Application contains a README with the applications description, user stories and low-fidelity wireframes
- The README contains instructions on how to run the application
- The group worked as a cohesive team to compelte the project
- Every group member must contribute at least 1 feature into the Application
As before, try to find an idea that solves a problem you have. Now that we can persist data with Firebase and send HTTP requests to arbitrary APIs, there is virtually no limit to the type of app we can build. Be realistic about the scope of your project: 1 polished feature that solves a common or important problem is more valuable than many scrappy features of lower value.
While brainstorming ideas, visualise how you might present the project to a prospective employer. Is this project impressive because it solves an unaddressed problem? Because it is technically well-done? Because of the thoughtfulness of its UX?
Some APIs and libraries we can consider:
You will have roughly 8 course days to complete this project. We will observe the following timeline to keep us on track.
| Project Day | Checkpoint | Feedback |
|---|---|---|
| 0 | Ideation phase 1 Post project ideas in Slack for feedback |
SL to review ideas and share feedback |
| 1 | Ideation phase 2 |
SL to review planning docs and share feedback |
| 2 | Start implementation | - |
| 3 | - | - |
| 4 | - | - |
| 5 | MVP deadline |
SL to review code in GitHub, share feedback |
| 6 | - | - |
| 7 | Feature freeze No new features, focus on polishing existing features and code to be presentable |
SL to review progress and share post-feature-freeze suggestions |
| 8 | - | - |
| 9 | Project presentations Practise explaining your work to others. Other batches will join and we will celebrate each others' hard work. |
SL to review code in GitHub, share feedback in 30-minute post-mortem meeting |
| 10 | Demo video |
In addition to user story, wireframe and kanban board suggestions shared during Project 1, now that we have a database (DB), Rocket recommends we plan the DB schema before starting. Our DB schema will change during app development, but planning ahead can reduce the number of changes. Rocket recommends we revise the Firebase Realtime Database guide on structuring data before starting, and reviewing the Firebase Firestore guide on structuring data if we plan to use Firestore.
- Have 1 person create a GitHub repo and invite other team members as collaborators
- For each task in the kanban board, create a new feature branch from
main. Name the branch after the task. When the task is done, push the feature branch to GitHub, create a pull request (PR) and merge the code intomainfrom the PR in GitHub.
Team members will merge code to main regularly and we will want to incorporate those changes in our feature branch to ensure compatibility with main. Rocket recommends this operation before merging to main to test merge results on feature branch instead of main.
- Save & commit all changes on the current (non-
main) feature branch. Pull latest changes tomainwithgit pull origin main. - Merge
mainto feature branch withgit merge mainwhile on feature branch - Resolve any conflicts on feature branch. Follow instructions in console, using
git statusto see what steps are needed.
After committing changes and verifying our feature branch is compatible with main, we will merge our changes to main for our teammates to use.
- Push feature branch to GitHub with
git push, then create a PR to merge feature branch withmainon GitHub. - After merging PR in GitHub, run
git pull origin mainto get latestmainbranch changes from GitHub. - Delete feature branch locally with
git branch -d <FEATURE-BRANCH-NAME> - Delete feature branch on GitHub with
git push origin --delete <FEATURE-BRANCH-NAME>
Merge conflicts happen when Git is unsure how to merge 2 versions of a file. To resolve a merge conflict, use git status to find which files have conflicts, resolve the conflicts in each file by editing it to be what it should be, and run git commit to complete the merge. We can reduce the chance of merge conflicts by communicating often with our team and merging latest changes from main to our feature branch regularly.
Start by forking Rocket's Bootcamp Project 2 repo that contains an empty CRA app. This will make it easier for SLs to review your code via pull requests.
Rocket recommends deploying to Firebase Hosting as per Create React App official docs because Firebase Hosting allows for client-side routing by React Router, unlike GitHub Pages.
- Submit a pull request to Rocket's Project 2 repo
- Add your Project 2 repo link to the Rocket Bootcamp Projects spreadsheet in your batch-specific sheet. Feel free to review past student projects in previous batches' sheets.
- Code the foundation of the app together before splitting up to code individual features. This will reduce merge conflicts and help everyone gain a common understanding of how the app should work.
- Implement the primary user story first. What are users coming to your app to do? Ensure they are able to accomplish that before adding authentication and nice-to-have features.