Welcome to
TinyHouse: A Fullstack React Masterclass with TypeScript and GraphQL - Part Two
Course Syllabus and Content
Introduction
5 Lessons 56 Minutes
Welcome to Part II of the course.
In this lesson, we'll highlight all the features we intend to have for our home sharing application, TinyHouse.
We'll spend a few minutes walking through the complete TinyHouse code for Part II of the course to gather context on some of the patterns we'll follow.
In this lesson, we'll continue from the previous lesson and spend more time discussing common patterns we'll employ as we build both the server and client projects of the TinyHouse application.
The structure of the course, the material available, and how best to go through the course in Part II.
Set-up for Part 2
1 Lesson 2 Minutes
We begin working on building the TinyHouse application by first modifying the code from the end of Part I of the course to prepare us as we move forward.
Routing in TinyHouse
3 Lessons 14 Minutes
This is an introduction to the work we'll be doing in Module 2.0.
Routing is the process of navigating through a web application with the help of URLs. When a link in a webpage is clicked, the URL changes which then navigates a user to a new page. In this lesson, we'll learn about routing and explore the different routes we'll need for our TinyHouse application.
React Router is a popular community-built library that provides a set of navigational components to help create routing within React applications. In this lesson, we'll use React Router to declare the main routes and the components that should be shown in these routes for our TinyHouse client application.
Setting up our Database
4 Lessons 30 Minutes
This is an introduction to the work we'll be doing in Module 3.0.
In this lesson, we'll brainstorm the structure of our database and determine how many collections the database for our TinyHouse application will need.
We continue from the previous lesson by declaring the shape of the data we expect to store in each of the collections of our database.
Having our database contain some mock data will allow our GraphQL queries and mutations to interact with data from the database. In this lesson, we'll create a scripts to help seed and clear the database of mock data, in development.
User Authentication with Google Sign-In & OAuth 2.0
10 Lessons1 Hours 40 Minutes
This is an introduction to the work we'll be doing in Module 4.0.
OAuth is an industry-standard authorization protocol that enables applications to obtain limited access to user accounts without giving away any passwords. In this lesson, we'll dive a little deeper explaining what OAuth is and how we intend to use it in our application to help users sign-in with their Google account.
In this lesson, we'll create the necessary OAuth credentials from the Google API Console that we'll need to use to set-up Google OAuth in our application.
We'll begin creating the GraphQL fields that we'll need to help us establish Google OAuth in our application.
Before we update our GraphQL OAuth resolvers, we'll use Google's official Node.js library to help access and interact with Google APIs.
We'll continue to update the GraphQL resolver functions we've prepared to allow users to log-in & log-out of our application.
We'll now switch over to work in our React application and have it communicate with the server to allow a user to sign-in via Google OAuth.
Having the UI of the Login page built in our client, we'll investigate how we can make the query for Google Sign In's authentication URL when a user attempts to sign in.
A user is now able to successfully sign-in from the Login page. In this lesson, we'll spend some time creating the AppHeader component that will help allow users to navigate around our app.
This lesson is a summary of the work we've done in Module 4.0.
Persist Login Sessions with Cookies
7 Lessons 41 Minutes
This is an introduction to the work we'll be doing in Module 5.0.
A browser cookie is data that a server can send to a user's web browser where the browser can often send back to the server. With this lesson, we begin discussing how persistent login sessions can be made with cookies by going through a simple exercise with the Google search web application.
Before we dive into implementing persistent login sessions in our app, we'll touch on the different storage mechanisms of the web browser. In this lesson, we explore the differences between localStorage, sessionStorage, and cookies.
We'll utilize the
cookie-parserpackage in our Node server to help parse a "viewer" cookie from HTTP requests sent from the client.Our server is now able to help set and clear the "viewer" cookie in our client when we sign-in with Google. In this lesson, we'll modify our client such that it will use the "viewer" cookie to automatically log a viewer in when the app first renders and the cookie is available.
We’ll take an additional step in this lesson to prevent Cross-Site Request Forgery attacks. We'll see how we can have the client pass a CSRF token with every request and where the server can use the token to verify the identity of the viewer making the request.
This lesson is a summary of the work we've done in Module 5.0.
Building the User Page
7 Lessons1 Hours 48 Minutes
This is an introduction to the work we'll be doing in Module 6.0.
In this module, we begin building the server and client implementation that will help allow us to retrieve and display information for users in our application. We'll begin by brainstorming the GraphQL fields we'll need to query user data.
In this lesson, we'll modify the User, Listing, and Booking GraphQL type definitions that are relevant to the user information we want to query from the database.
With the GraphQL type definitions established for the root-level user query, in this lesson we'll modify the resolver function we have to help query for a certain user.
With our
userquery now prepared and available in our GraphQL API, we'll begin building the page shown in the/user/:idroute of our client app.In this lesson, we'll continue to build the user page in our client application by looking to query and present a paginated list of listings and bookings for a certain user.
This lesson is a summary of the work we've done in Module 6.0.
Building the Listing Page
7 Lessons1 Hours 35 Minutes
This is an introduction to the work we'll be doing in Module 7.0.
In this module, we begin building the server and client implementation that will help allow us to retrieve and display information for listings in our application. We'll begin by brainstorming the GraphQL fields we'll need to query listing data.
With the root-level
listingfield prepared in our GraphQL API, we'll construct the resolver function for this field to attempt to query for the appropriate listing from the "listings" collection in our database.With our
listingquery now prepared and available in our GraphQL API, we'll begin building the page shown in the/listing/:idroute of our client app.In this lesson, we'll continue to build the listing page in our client application by looking to prepare the
<ListingDetails />and<ListingBookings />components.In this lesson, we'll finish up our client update for the listing page by creating the component where a user will eventually use to book for a listing.
This lesson is a summary of the work we've done in Module 7.0.
Building the Home Page
6 Lessons1 Hours 3 Minutes
This is an introduction to the work we'll be doing in Module 8.0.
In the homepage of our application, we hope to display a small list of the most premium listings available. In this module, we begin building the server and client implementation that will help allow us to retrieve and display listings information for the homepage of our application. We'll begin by brainstorming the GraphQL fields we'll need to query a list of listings from our API.
With the root-level
listingsfield prepared in our GraphQL API, we'll construct the resolver function for this field to attempt to query for a list of listings from the "listings" collection in our database.The homepage of TinyHouse is to be to mostly presentational and aims to serve the purpose of telling the user what our app does as well as provide useful links to direct them elsewhere. In this lesson, we focus on building the presentational UI of the homepage.
Our homepage is mostly prepared except for displaying the most premium (i.e. highest price) listings. In this lesson, we'll look to make the query we'll need to retrieve the highest priced listings from our server and display that information on our homepage.
This lesson is a summary of the work we've done in Module 8.0.
Searching for listings with Google's Geocoding API
9 Lessons2 Hours 4 Minutes
This is an introduction to the work we'll be doing in Module 9.0.
We've managed to create the capability for users to query for a list of listings that can be sorted based on listing price. In this module, we'll focus on the functionality that will allow our users to search for listings based on location. We'll begin the investigation for this by discussing the API we intend to use to help us - Google's Geocoding API.
In this lesson, we'll address the gameplan we have in mind in how we want to conduct location-based searching in our app.
In this lesson, we'll begin to write the code in our server project to help allow a user to search for listings in a certain location. To achieve this, we'll first modify the existing
listingsGraphQL query field to accept an optionallocationargument that when provided will return the listings that pertain only to that location.With our
listingsfield in our GraphQL API prepared to accept alocationargument, we'll begin to work on the client app to build the/listings/:location?page for where certain listings can be shown for specific locations.At this point, we have a page displayed in the
/listings/location?route that surfaces up to eight different listing cards for listings that exist in certain locations. In this lesson, we'll create the capability for a user to filter and paginate the information presented to them in the listings page.In this lesson, we'll work on something slightly related to the
/listings/:location?page and is a big factor of our app. We'll be working on the search input that we'll place in the app header that will allow users to search for listings in a location while within any part of our app.At this moment in time, we've introduced the capability to have our client application query for listing documents for different locations. In this lesson, we'll investigate and discuss indexes within MongoDB and see how can index location-based data from the "listings" collection in our database.
This lesson is a summary of the work we've done in Module 9.0.
Connecting with Stripe
8 Lessons1 Hours 29 Minutes
This is an introduction to the work we'll be doing in Module 10.0.
It's finally time we talk about payments! The business model of TinyHouse is an online marketplace where users can host and book listings. In this lesson, we'll learn about how we intend to have TinyHouse be a marketplace by using the third-party payment platform - Stripe.
When a user in our application plans to host a listing, we'll need to ensure they've connected to their own Stripe account through our Stripe platform account. This is to leverage Stripe Connect's capability to pay the users who have listings in our app when a booking is made. In this lesson, we'll set up the credentials we'll need from Stripe and save them as environment variables for both our server and client projects.
We'll begin creating the GraphQL fields that we'll need to help us establish Stripe Connect OAuth in our application.
We'll continue to update the GraphQL resolver functions we've prepared to allow users to connect & disconnect from Stripe in our application.
We'll switch over to work in our React application and have it communicate with the server to allow a user to connect with their Stripe account on our platform.
We've managed to create the functionality to have a logged-in user in our app connect with Stripe. In this lesson, we'll look to visually indicate that the user is in the connected state and have an action responsible for allowing the user to disconnect from Stripe.
This lesson is a summary of the work we've done in Module 10.0.
Hosting new listings
6 Lessons1 Hours 30 Minutes
This is an introduction to the work we'll be doing in Module 11.0.
For users in our application to add listings (i.e. host listings) in the TinyHouse application, we'll need to create the functionality where users can upload and insert new listing data into our database. In this lesson, we'll establish the GraphQL fields in our API that will help achieve this.
We'll continue from what we've done in the previous lesson by having the
hostListingresolver function we've created receive an input with new listing information which will then be added to the"listings"collection in our database.We'll now begin to work on the form on the client application where a user can create (i.e. host) a new listing. The form we'll build will essentially be the UI of the
/hostroute of our application.The majority of the work we've needed to do for the form shown in the
/hostpage was completed in the last lesson. In this lesson, we collect the values a user is to enter in the form and when the user decides to submit the form, we'll trigger thehostListingmutation we have in our API and pass the relevant input along.This lesson is a summary of the work we've done in Module 11.0.
Cloudinary & Image Storage
3 Lessons 16 Minutes
This is an introduction to the work we'll be doing in Module 12.0.
In this lesson and module, we'll investigate to see if there's a better way of storing the newly created images for listings in our database. We'll discuss and investigate cloud-based image and video management services and see how we can use Cloudinary for our application.
In this lesson, we'll pick up from what we've done in the previous lesson by modifying our server code to utilize Cloudinary to host listing images for our TinyHouse application.
Booking listings
9 Lessons2 Hours 34 Minutes
This is an introduction to the work we'll be doing in Module 13.0.
For users to book a listing in our app, we'll need functionality to handle this as well as the capability to process transactions between the tenant and host. In this lesson, we'll establish the GraphQL fields in our API that will help achieve this.
Before we begin to implement the
createBookingmutation resolver, we'll first create the utility function that will facilitate a Stripe charge with the help of Stripe's API.In this lesson, we'll continue from the previous lesson and look to see how we can update the bookingsIndex of a listing document with the dates that have recently been booked by a tenant.
In this lesson, we'll begin to work on the client-side to facilitate the booking of a listing. We'll begin by first disabling any dates in the listing page datepickers that have been previously booked by other users.
In this lesson, we'll look to prepare the confirmation modal that gets displayed to the user when the users requests to make a booking.
We'll continue from what we've done in the previous lesson by looking to capture a user's credit or debit card information when a booking is to be made, with the help of the React Stripe Elements library.
In this lesson, we'll wrap-up what we've done in the last few lessons by now collecting all relevant information and triggering the
createBookingmutation when a user is ready to confirm their booking.This lesson is a summary of the work we've done in Module 13.0.
Deploying with Heroku
4 Lessons1 Hours 2 Minutes
This is an introduction to the work we'll be doing in Module 14.0.
We've finished building the application that we've wanted so we'll now focus on deployment. There's no use in having a great app if we can't deploy it for others to use! Before we dive into what form of deployment we're going to conduct, we'll talk about cloud computing and its importance when it comes to the world of deployment.
Heroku is a platform as a service (PaaS) that's been around since June 2007 and supports the deployment of several programming languages. In this lesson, we'll use Heroku to help deploy our TinyHouse application on to the cloud!
For the last core lesson of the course, we'll take a walkthrough of our deployed app to ensure everything works as intended. By the end of this lesson, we'll also spend a little time quickly summarizing what we've done to have our application be deployed.
Bonus Module
7 Lessons1 Hours 4 Minutes
This is an introduction to the work we'll be doing in Module 15.0.
In this lesson, we build the UI for the NotFound page shown when a user ever navigates to a route not defined in our app.
We discuss Apollo Client's intelligent caching system and ways one can manipulate the fetch policy of query requests.
We'll see how React's useLayoutEffect Hook can help have our application window be scrolled to the top when we navigate from page to page.
We'll discuss the small changes that can be made to use some of the new Hooks that React Router provides.
We'll discuss a small change that can be made to fully disconnect a user from our Stripe Connect account when they've disconnected from Stripe in our app.
We'll discuss a few small changes that can be made to optimize the date pickers for when a user is to book a certain listing.
Part Two Conclusion
1 Lesson 40 Seconds
Conclusion of Part II of the course.
PostgreSQL & TypeORM
5 Lessons1 Hours 1 Minutes
This is an introduction to the bonus work we'll be doing in Module 17.0.
In this lesson, we compare SQL and NoSQL databases.
This lesson is an introduction to the popular and widely used open-source SQL database, PostgreSQL.
Object-Relational Mapping (ORM) is a technique that lets one access and modify data from a database using an object-oriented paradigm. In this lesson, we'll discuss ORM and be introduced to a popular ORM used for JavaScript and TypeScript, TypeORM.
In this lesson, we'll convert the server of our TinyHouse project to use PostgreSQL & TypeORM.
Unit Testing (Client)
8 Lessons2 Hours 21 Minutes
This is an introduction to the bonus work we'll be doing in Module 18.0.
In this lesson, we introduce the concept and benefits of unit testing in web applications.
In this lesson, we'll talk about the two main testing tools we'll use to test our React components - Jest & React Testing Library.
In this lesson, we'll talk about one other minor testing utility we'll use to help mock GraphQL requests in our tests - Apollo React Testing.
In this lesson, we'll begin installing the testing libraries we are to use on the client application.
In this lesson, we begin preparing tests for the Home component.
In this lesson, we complete our tests for the Home component.
In this short lesson, we'll take a bit of a tangent and talk about something we haven't talked about it in the course - creating Pull Requests for features
Package Updates
1 Lesson
This section discusses the migration from @google/maps to @googlemaps/google-maps-services-js.