The video below highlights the syllabus and course overview of the Tinyhouse Masterclass.
The document displayed in the video can be found - here.
How To Go Through The Course
The video below highlights the structure of the course, the material available, and how best to go through the course.
This section below highlights all the modules/lessons and breakdown of the material, for TinyHouse, that has been prepared and is currently available in the Newline platform. This section will update automatically when new modules and lessons get introduced and/or changed.
All the existing material shown below pertains to Part I of the course. We'll ensure this section is fully updated when Part II has launched in Q1 2020. ❄️
Introduction to the TinyHouse Masterclass.
Syllabus and course overview.
How To Go Through The Course
The structure of the course, the material available, and how best to go through the course.
Quick walkthrough of the development environment and tools used in the course.
Part One Welcome
Welcome to Part I of the course.
Module 1 Introduction
This is an introduction to the work we'll be doing in Module 1.0.
What is Node?
Creating a minimal Node:Express Server
Web servers provide functionality for requests that can be made from client applications. Node has a built-in HTTP module to allow for building a server that facilitates the transfer of data in HTTP. With this lesson, we'll look to use the popular Express framework as the replacement of the core HTTP module to create a minimal Node server, with Express routing.
Automatic Reloading Using Nodemon
Nodemon is an open-source utility tool that helps automatically restart a Node server whenever a change in code is detected in development. In this lesson, we'll install Nodemon and introduce an application script that will start the Node server with Nodemon.
Adding TypeScript to our Server
We'll get started with TypeScript in this lesson by installing a few necessary packages in our server and setting up the configuration of our TypeScript compiler.
Compiling our TypeScript project
Linting with ESLint
Introducing mock listings
To help us get started, we'll begin by introducing a mock data array of rental listings in this lesson. This will help us get started before we begin to address more appropriate data persistence.
Creating GET and POST Express routes
In this lesson, we'll use the routing capabilities Express gives us to create GET and POST routes that interact with the mock data array we've established.
Module 1 Summary
This lesson is a summary of the work we've done in Module 1.0.
Module 2 Introduction
Introduction to Module 2.0.
What is GraphQL?
GraphQL is a query language for APIs. In this lesson, we go through an initial discussion on GraphQL and how GraphQL differs from traditional REST APIs.
Comparing Github's REST and GraphQL APIs
Before we continue discussing some of the core concepts in GraphQL, we'll take a bit of a tangent in this lesson to contrast and compare Github's existing REST API (v3) and their GraphQL API (v4).
In this lesson, we introduce and discuss some of GraphQL's main concepts such as the GraphQL schema, object types and resolver functions.
Module 3 Introduction
Introduction to Module 3.0.
Installing Apollo Server and GraphQL
Creating a GraphQL Schema with the GraphQL JS Library
Querying and mutating listings data with GraphQL
In this lesson, we'll look to mimic the listings retrieval and manipulation we had in our Express RESTful API but with GraphQL instead.
Using the GraphQL Schema Language
The GraphQL schema language is a human-readable syntax to help create GraphQL schemas. In this lesson, we'll use the GraphQL schema language to re-create the schema we have in a more readable and simpler format.
Module 3 Summary
This lesson is a summary of the final state of the work done in Module 3.0.
Module 4 Introduction
Introduction to Module 4.0.
Introduction to MongoDB
This brief lesson highlights some of the differences between relational and non-relational databases, and introduces MongoDB.
Setting up a new MongoDB Cluster with Atlas
MongoDB Atlas is a fully managed cloud database service built and maintained by the same team behind MongoDB. In this lesson, we'll create our first MongoDB cluster with MongoDB Atlas.
Connecting the server with MongoDB
Many different libraries and tools exist to help facilitate the connection between a Node Server and a MongoDB instance. In this lesson, we'll introduce and use the Node MongoDB driver to make our server connect with the MongoDB cluster we've created in Atlas.
TypeScript Generics and adding types to our Collections
Though we've been able to make our database connection from the server, we haven't appropriately specified the type of data that can be returned from our database collections. In this lesson, we introduce and take advantage of generics to define the type of data that can be returned from our listings collection.
Setting Up Env Variables
Defining and using environment-specific configuration variables within code files is less than ideal due to security reasons as well as the coupling of environment-specific configuration and application code. In this lesson, we'll avoid declaring our MongoDB environment variables directly in our database connection file and instead use the popular dotenv package to load environment variables from a .env file.
Seeding mock data to the 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 simple seed script that will make it easy for us to populate the database with mock data in development.
Processing Data from MongoDB
In this lesson, we'll look to have our GraphQL API resolvers interact and manipulate data in our Mongo database. This will help ensure persistence of data and data changes between server restarts.
In this lesson, we'll see how we can use the lodash merge function to have our GraphQL resolvers map be broken down to small resolvers objects that pertain to certain domains (i.e modules).
Module 4 Summary
This lesson is a summary of the work done in Module 4.0.
Module 5 Introduction
Introduction to Module 5.0.
This lesson provides a quick revision on some of the main topics behind developing UI applications with React.
Create React App
A lot of things need to be considered to create the scaffold of a modern React application, like allowing for a modular-based app, compiling ESNext code, transpiling TypeScript code, etc. To avoid spending too much time with build tools, we'll create a modern React/TypeScript application with a single command - create-react-app.
Create React App - The Rundown
create-react-app creates a series of files and folders as it instantiates and creates a Webpack bundled React application. In this lesson, we'll spend some time addressing and highlighting each of the files and folders scaffolded by create-react-app.
Module 6 Introduction
Introduction to Module 6.0.
The Listings Component
In this lesson, we'll create our first React Function component.
Props & TypeScript
In this lesson, we'll introduce and type define Props to our recently created Listings function component.
Functional Components & TypeScript
In this lesson, we'll investigate the FunctionComponent interface type React provides and address the type checking capabilities it provides when assigned to functional components.
Numerous tools and libraries exist to help clients make GraphQL requests to a GraphQL API. Before we begin to introduce a third-party library to help make our GraphQL requests, we'll look to make our requests with the help of the window Fetch API. In this lesson, we'll begin to make the connection between our React client and Node server and see if we can query the listings query from our GraphQL API.
Abstracting the type of data from server fetch
Although the custom server fetch() function we've established in the last lesson works, the data being returned isn't appropriately typed. In this lesson, we'll take advantage of TypeScript generics to ensure we get queried data from our server fetch() function with the appropriate type.
Deleting a listing
In this lesson, we'll use our custom server fetch() function to invoke the deleteListing mutation we have in our GraphQL API, to delete a listing in our listings collection.
Module 6 Summary
This lesson is a summary of the work done in Module 6.0.
Module 7 Introduction
Introduction to Module 7.0.
In this lesson, we discuss the motivation behind React Hooks and see a few examples of how React Hooks can help share logic between our React components.
The useState Hook
Though we've been able to create a custom fetch() function to help us make the GraphQL requests to query listings or delete a certain listing, we've only seen the results of our requests in our browser console. In this lesson, we'll introduce and use React's useState Hook to track listings state value in our function component with which we'll be able to use and display in our UI.
The useEffect Hook
We've managed to use the useState Hook to track and display listings data to our UI. In this lesson, we'll introduce the useEffect Hook and see how we can create an effect callback to query listings data the moment our component mounts.
Custom useQuery Hook
With React's useState and useEffect Hooks, we've been able to query and display listings information the moment our Listings component is mounted. In this lesson, we'll create our very own custom useQuery Hook that will consolidate the pattern of creating a state property, using the useEffect Hook, and running the server fetch() function to make a query and state update when a component mounts.
Custom useQuery and refetch
In this lesson, we'll introduce the capability for a component to manually refetch a query from the useQuery Hook.
Custom useQuery and loading/error states
In this lesson, we'll address how we can handle the loading and error state of our GraphQL queries with our custom useQuery Hook.
Custom useMutation Hook
In this lesson, we'll create a custom useMutation Hook which will abstract the server fetch functionality needed to conduct a mutation from a component.
The useReducer Hook
In this lesson, we'll configure the useQuery and useMutation Hooks we've created to use another state management Hook to handle state. We'll use React's useReducer Hook.
Module 7 Summary
This lesson is a summary of the work done in Module 7.0.
Module 8 Introduction
Introduction to Module 8.0.
Creating our Apollo Client
To use the React Apollo client library, we'll install and set up the Apollo client of our application with which we'll be doing in this lesson.
React Apollo Hooks
With the Apollo client available everywhere in our app, we'll replace the use of the custom useQuery and useMutation Hooks with the variations provided to us from the React Apollo library.
Autogenerated types with Apollo CLI
In this lesson, we'll use Apollo tooling's command line interface to autogenerate static types for the GraphQL requests in our client application.
Module 8 Summary
This lesson is a summary of the work done in Module 8.0.
Module 9 Introduction
Introduction to Module 9.0.
UI Frameworks and Ant Design
In this lesson, we discuss some of the benefits of using a React UI framework as well as the Ant Design UI library.
Styling with Ant Design
Throughout Part I of the course, we haven't made any changes to the presentation (i.e. CSS) of our client code. In this lesson, we'll introduce and use the Ant Design React UI framework to improve the appearance of our client application.
Part One Conclusion
Conclusion of Part I of the course.
Module 11 Pro
Part Two Welcome
Welcome to Part II of the course.
The TinyHouse App
In this lesson, we'll highlight all the features we intend to have for our home sharing application, TinyHouse.
Walkthrough of TinyHouse Code
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.
Code Patterns & Behavior
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.
How To Go Through The Course
The structure of the course, the material available, and how best to go through the course in Part II.
Module 12 Pro
Set-up For Part II
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.
Module 13 Pro
Module 2 Introduction
This is an introduction to the work we'll be doing in Module 2.0.
Routing in TinyHouse
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.
Module 14 Pro
Module 3 Introduction
This is an introduction to the work we'll be doing in Module 3.0.
Database Collection Structure
In this lesson, we'll brainstorm the structure of our database and determine how many collections the database for our TinyHouse application will need.
Database Document Structure
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.
Seed & Clear Data from MongoDB
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.
Module 15 Pro
Module 4 Introduction
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.
Google Sign-In (OAuth)
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.
Google Sign-In GraphQL Fields
We'll begin creating the GraphQL fields that we'll need to help us establish Google OAuth in our application.
Using Google Sign-In & People API
Before we update our GraphQL OAuth resolvers, we'll use Google's official Node.js library to help access and interact with Google APIs.
Building the Authentication Resolvers
We'll continue to update the GraphQL resolver functions we've prepared to allow users to log-in & log-out of our application.
Building the UI for Login
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.
Building the AppHeader & Logout
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.
Module 4 Summary
This lesson is a summary of the work we've done in Module 4.0.
Module 16 Pro
Module 5 Introduction
This is an introduction to the work we'll be doing in Module 5.0.
Cookies & Login Sessions
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.
localStorage vs. sessionStorage vs. cookies
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.
Adding the Viewer Cookie on the Server
We'll utilize the `cookie-parser` package in our Node server to help parse a "viewer" cookie from HTTP requests sent from the client.
Adding the Viewer Cookie on 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.
Module 5 Summary
This lesson is a summary of the work we've done in Module 5.0.
Module 17 Pro
Module 6 Introduction
This is an introduction to the work we'll be doing in Module 6.0.
User GraphQL Fields
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.
Modifying the User, Listing, and Booking GraphQL TypeDefs
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.
Building the User Resolvers
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.
The UserProfile React Component
With our `user` query now prepared and available in our GraphQL API, we'll begin building the page shown in the `/user/:id` route of our client app.
The UserListings & UserBookings React Components
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.
Module 6 Summary
This lesson is a summary of the work we've done in Module 6.0.
Module 18 Pro
Module 7 Introduction
This is an introduction to the work we'll be doing in Module 7.0.
Listing GraphQL Fields
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.
Building the Listing Resolvers
With the root-level `listing` field 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.
Querying for listing data
With our `listing` query now prepared and available in our GraphQL API, we'll begin building the page shown in the `/listing/:id` route of our client app.
ListingDetails & ListingBookings
In this lesson, we'll continue to build the listing page in our client application by looking to prepare the `<ListingDetails />` and `<ListingBookings />` components.
The ListingCreateBooking React Component
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.
Module 7 Summary
This lesson is a summary of the work we've done in Module 7.0.
Module 19 Pro
Module 8 Introduction
This is an introduction to the work we'll be doing in Module 8.0.
Listings GraphQL Fields
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.
Building the Listings Resolvers
With the root-level `listings` field 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.
Building the UI of the Homepage
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.
Displaying the highest-priced listings in 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.
Module 8 Summary
This lesson is a summary of the work we've done in Module 8.0.
Module 20 Pro
Module 9 Introduction
This is an introduction to the work we'll be doing in Module 9.0.
Google's Geocoding API
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.
Location-based searching for listings
In this lesson, we'll address the gameplan we have in mind in how we want to conduct location-based searching in our app.
Updating the listings resolver
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 `listings` GraphQL query field to accept an optional `location` argument that when provided will return the listings that pertain only to that location.
Building the Listings page
With our `listings` field in our GraphQL API prepared to accept a `location` argument, 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.
Pagination & Filtering in the Listings page
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.
Searching for listings from the App Header
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.
Index location-based data
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.
Module 9 Summary
This lesson is a summary of the work we've done in Module 9.0.
Module 21 Pro
Module 10 Introduction
This is an introduction to the work we'll be doing in Module 10.0.
Stripe & Stripe Connect
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.
Stripe Connect OAuth
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.
Stripe Connect GraphQL Fields
We'll begin creating the GraphQL fields that we'll need to help us establish Stripe Connect OAuth in our application.
Building the Stripe Connect Resolvers
We'll continue to update the GraphQL resolver functions we've prepared to allow users to connect & disconnect from Stripe in our application.
Connecting with Stripe on the Client
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.
Disconnecting from Stripe on the Client
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.
Module 10 Summary
This lesson is a summary of the work we've done in Module 10.0.
Module 22 Pro
Module 11 Introduction
This is an introduction to the work we'll be doing in Module 11.0.
HostListing GraphQL Fields
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.
Building the HostListing Resolver
We'll continue from what we've done in the previous lesson by having the `hostListing` resolver function we've created receive an input with new listing information which will then be added to the `"listings"` collection in our database.
Building the UI of the Host page
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 `/host` route of our application.
Executing the HostListing Mutation
The majority of the work we've needed to do for the form shown in the `/host` page 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 the `hostListing` mutation we have in our API and pass the relevant input along.
Module 11 Summary
This lesson is a summary of the work we've done in Module 11.0.
Module 23 Pro
Module 12 Introduction
This is an introduction to the work we'll be doing in Module 12.0.
Cloudinary & Image Storage
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.
Image uploads with Cloudinary
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.
Module 24 Pro
Module 13 Introduction
This is an introduction to the work we'll be doing in Module 13.0.
CreateBooking GraphQL Fields
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.
Building the CreateBooking Resolver
Before we begin to implement the `createBooking` mutation resolver, we'll first create the utility function that will facilitate a Stripe charge with the help of Stripe's API.
Resolving the BookingsIndex of a Listing
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.
Disabling booked dates on the client
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.
Creating the Booking Confirmation Modal
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.
Displaying the Payment Form with React Stripe Elements
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.
Executing the CreateBooking Mutation
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 `createBooking` mutation when a user is ready to confirm their booking.