Introduction to Modernizing an Enterprise React App

Video Course Overview - Modernizing an Enterprise React App

Get familiar with the sample React application's folder structure and current functionality.

What We'll Build In This React Course - Hardware Handler

Introduction

Module 1 Introduction

Learn about the motivation behind React Hooks, the benefits it can bring, and the rules that apply to all Hooks in a React application.

React Hooks - Understanding The Basic Rules and Benefits

The useState Hook is the most similar to traditional state in React class-based components, and we'll look at examples of how it works to keep track of state in functional components.

React's useState Hook - Track Functional Component States

useEffect is a game-changing hook: originally compared to lifecycle methods in React components, it's close but not truly a direct comparison.

How Does React's useEffect Hook Work?

While less often discussed, the useRef Hook deserves covering because a time will come when it's the right solution to reach for; here, we'll talk about how useRef's "mutable" value property can be useful.

Learning About The React useRef Hook And Mutable Values

Context is a powerful API to pass state within React applications, and with the introduction of the useContext Hook, accessing state in any component (class or functional) is possible.

A Step-by-Step Guide to Using React's useContext Hook

Custom hooks are arguably the most important addition of all the hooks released with React 16.8.0. Explore how custom hooks can dramatically simplify sharing code between components.

An Introduction To Custom Hooks In React

This lesson is a summary of the React Hooks we've covered in Module 1.0

Module 1 Summary

React Hooks

Introduction to Module 2: Upgrading React App Version

Module 2 Introduction

Before we can do anything else, we must upgrade our sample app's React version to start taking advantage of the advances.

Upgrade the React app version

Avoid one of the most common developer woes: different devs coding with different environment versions with the help of Volta and Node Engines.

Dev Teams, Lock Down Environment Versions With Volta

This lesson is a summary of module 2.0, where we upgraded our React version and locked in our project configuration.

Module 2 Summary

Upgrade the React App

Introduction to module 3: Code formatting setup

Module 3 Introduction

Code formatting, especially when it's set up, so you don't even have to think about it, is the best.

Code Formatting - An Overview Of Prettier And How To Set It Up

Make JavaScript code quality better and avoid bugs with the help of a linter and a strict set of rules.

How To Set Up ESLint For Modernizing A React App

This lesson is a summary of the automated code formatting and linting we set up with the help Prettier and ESLint in Module 3.0.

Module 3 Summary

Configure Prettier and ESLint

Introduction to Module 4: Refactoring to hooks

Module 4 Introduction

We dip our toes into converting a class component to a functional one with Hardware Handler's home page.

Refactor Home.js

We get our first real taste of adding hooks while refactoring the App component.

Refactor App.js

The checkout page uses multiple API calls to correctly display the items a product manager wants to ship to stores.

Refactor Checkout.js

Ah forms, a painful Achilles heel of most web applications (React apps included) since the beginning of time.

Refactor ProductForm.js

We saved the best (i.e. the most complicated) component for last. The product list, with its filters and products, is no match for our newly honed skills though.

Refactor ProductList.js

This lesson is a summary of Module 4.0, where we systematically refactored our app's outdated class components to now use React Hooks.

Module 4 Summary

Refactor React Classes to React Hooks

Module 5 Introduction

We'll write our first custom hook to fetch department info for our application in one centralized place.

Our First Custom Hook: useDepartments

Custom hooks are good for more than just drying up duplicated code; they also help simplify our components.

Simplify Complex Components with the useProducts Hook

Some custom hooks can help simplify code beyond the original components they touch.

The useCheckout Hook will do Double Duty in our App

This lesson is a summary of module 5.0's custom hooks we added to Hardware Handler.

Module 5 Summary

Create Custom Hooks for the App

Introduction to module 6: The useContext Hook

Module 6 Introduction

Bring the Context API into Hardware Handler to decrease our reliance on props.

Simplify React Prop Management With A Context Hook

Context doesn't necessarily need to live at the top level of a component to be useful.

Setting Up Contexts To Share Functions Within A React App

This lesson summarizes our addition of the Context API and useContext Hooks in Module 6.0.

Module 6 Summary

Incorporate the Context API

Module 7 Introduction

This library took aim at a few fundamental flaws in the traditional way of integration testing JavaScript applications and really changed the game when it comes to automated testing.

Introducing React Testing Library And Its Automation Capabilities

We've got a little setup work to do before we get to the actual business of writing our tests.

Strategies For Simplifying Integration Testing For React Apps

React Testing Library's approach to integration testing like a user would interact with the DOM works very well with React's function-based components.

How To Write Tests For React Container Components

Test Hardware Handler's custom hooks

Not all of our testing for our React app relies so heavily on RTL — some files Jest can handle on its own.

A Guide To API Service Layer Testing With The Jest Framework

This lesson is a summary of module 7.0, where we started adding unit and integration tests to our app to increase our confidence our app works as expected.

Module 7 Summary

Integration Testing with Jest and React Testing Library

Module 8 Introduction

End-to-end testing has never been the easiest thing to do, but Cypress challenges that statement in a big way.

Cypress.io And End-To-End Testing - What You Need To Know

Cypress gives us a big helping hand organizing and getting started with our own e2es.

Add Cypress To A React App For Automated End-To-End Testing

Cypress makes the process of writing e2es relatively simple with lots of built-in methods and documentation to show you the way to use it effectively.

Write And Run End-To-End Test Flows With Cypress.io

The Studio feature makes e2e test writing faster and easier than it's ever been before.

Try out Cypress Studio

This lesson is a summary of module 8.0, where we integrated Cypress into a React app and wrote automated end-to-end tests.

Module 8 Summary

End-to-End Testing with Cypress

Introduction to module 9: Design system libraries

Module 9 Introduction

Design systems provide more than just a bunch of prebuilt components for developers.

Why use a Design System?

Setting Ant Design up takes a little doing because it's so customizable.

How To Add Ant Design System To A React App

Ant Design's thorough documentation makes the process of replacing custom components less difficult than it might otherwise be.

Swap out Some Simple Components

While these components require a little more effort to get working, the improvements they provide are worth the time.

How To Add An Ant Design System Form To A React App

This lesson summarizes module 9.0, where we learned about the benefits of a design system and incorporated the popular Ant Design into our own app.

Module 9 Summary

Bonus Module: Add a Design System Library

Recapping Modernizing an Enterprise React App

Summing It All Up

In this course we'll dive into all the ways to modernize an existing React application - from tooling and linting, to testing and Hooks. React is a powerful, extremely popular JavaScript framework, but keeping applications up to date with all that it has to offer is tough - especially when dealing with the larger, enterprise-level business applications many developers are responsible for.

## Why this course

The newline Guide to Modernizing an Enterprise React application will cover everything you need to know to confidently work on a React application of any size, in any state, and leave it better than when you found it. 

While many React tutorials start with the latest version of React, or gloss over all the other things required to make sure apps vital to a company's success keep running, this course does not. In 54 lessons spanning 10 modules, it tackles head-on, the many things that must be considered when building and maintaining large, complex React apps.

## Course modules 

As you progress through this course, you'll gain a deeper understanding for how and why React Hooks came to be, the importance of various types of automated testing and project configuration, and how to leverage design systems to improve your application. You will gain a detailed understanding of how to modernize a React app in a real-world scenario, bringing it in line with today's development standards. 

![Home page of the Hardware Handler sample React application](https://d2uusema5elisf.cloudfront.net/courses/newline-guide-to-modernizing-an-enterprise-react-app/module_10/lesson_00.00/public/assets/hardware-handler-home-page.png)

### Part one: tooling and setup

The first part of this course will consist of getting familiar with our example application, and doing the behind-the-scenes work to set it up for success. 

We'll learn about why React Hooks came about and how to use them, how to upgrade an outdated React app successfully, and how to use tools like Volta, ESLint and Prettier to improve the app's code and development experience.

- Module 0: Meet Hardware Handler - our outdated, but promising React application.
- Module 1: [React Hooks](https://reactjs.org/docs/hooks-intro.html#motivation) - why they were created, the issues they solve and how the most common ones work.
- Module 2: Upgrading a React app - our app needs an upgrade to use Hooks, and we'll streamline development with [Volta](https://volta.sh/).
- Module 3: Project configuration - adding [Prettier](https://prettier.io/) and [ESLint](https://eslint.org/) to our app will dramatically improve code quality.  

### Part two: refactoring the code

With our app configured for success, we'll get down to the business of refactoring Hardware Handler. 

I'll show you my strategy for converting class components to functional ones, and we'll go file-by-file keeping the app's functionality intact while upgrading it to use hooks - including custom hooks, and the Context API. 

- Module 4: Classes to functions - we'll take every class component and turn it into a functional component.
- Module 5: [Custom hooks](https://reactjs.org/docs/hooks-custom.html) - we'll identify where custom hooks can simplify our functional components further.
- Module 6: [Context API](https://reactjs.org/docs/context.html) - a few strategically placed React contexts will round out our code improvements.

### Part three: testing

An updated application is only half the battle for enterprise-level apps; development teams must also be confident in their continued success as the apps expand in size and scope. 

We'll add automated testing to our app using the widely accepted testing frameworks React Testing Library and Cypress.

- Module 7: Integration testing - the popular combination of [Jest](https://jestjs.io/) and [React Testing Library](https://testing-library.com/docs/react-testing-library/intro/) will be used to unit test smaller pieces of our app.
- Module 8: End-to-end testing - the ease of writing e2es with [Cypress Studio](https://www.cypress.io/) will blow you away.

### Bonus: design systems

Finally, I've included a special bonus module about how to incorporate design systems into an already existing application, and switch out components in a systematic way. Design systems and component libraries are quickly gaining ground - especially in big orgs with lots of apps and development teams. 

Being able to effectively use one is an important skill to learn.

- Module 9: [Ant Design](https://ant.design/) - we'll swap in the robust design system's components to handle our app's more complex interactions for us.

![Product page of the Hardware Handler sample React application](https://d2uusema5elisf.cloudfront.net/courses/newline-guide-to-modernizing-an-enterprise-react-app/module_10/lesson_00.00/public/assets/hardware-handler-product-page.png)

## Bottom Line

In 10 modules, we'll go step-by-step taking an app from outdated in every way to up to today's high standards, giving you ample practice and hands-on examples along the way. 

If you've been wanting to get more confident in your React skills _and_ see what it takes to build enterprise apps in today's world, this is the course for you.

![Checkout page of the Hardware Handler sample React application](https://d2uusema5elisf.cloudfront.net/courses/newline-guide-to-modernizing-an-enterprise-react-app/module_10/lesson_00.00/public/assets/hardware-handler-check-out.png)

In this course, you'll learn all the pieces that go into modernizing an existing React application so it can take advantage of the latest framework features and run well for years to come.

The newline Guide to Modernizing an Enterprise React App

How to modernize an existing React application according to today's standards

How React Hooks work compared to class components

How config tools Volta and Node engines simplify development

How to set up ESLint and Prettier to improve code quality

How to upgrade an existing React app and refactor the app as you go

How to write integration tests with React Testing Library to ensure app functionality

How end-to-end tests with Cypress can test mission critical user flows

How to incorporate a component library to speed up design and development time

Hooks weren't introduced until React v16.8.0, but our app is currently running v16.4.0. The first thing we have to do is upgrade the version of React our application is running.

This lesson will walk through upgrading our app to use the latest version of React released to date.

If you were to attempt to add a hook to our app as it currently exists, you'd see an error in the browser's developer tools along the lines of:

Uncaught TypeError: Object(...) is not a function

It's not a very helpful error message, but after a quick 

, you'll figure out a React version that doesn't work with hooks is the actual issue.

If you need a fresh copy of the sample app 

Since we have an already existing Create React App, our path to upgrading is a little different than if we were starting from scratch with the most up-to-date version of React. Lucky for us, the 

 have a fairly well-documented upgrade process.

Check the CRA changelog for the latest react-scripts version

, and find the newest version of the react-scripts available.

At the time of writing this, the React Scripts are up to v4.0.3. They may be higher when you start — best to check the Create React App website.

If you scroll down past the initial notes of what new updates this version contains, you should see a section titled "Migrating from X.X.X to X.X.X".

Here are the npm and yarn commands we'll need to upgrade the 

, which can then be used to update the React versions in our project.

Copy the yarn command (or npm, if that's your preference): 

, and paste it into your terminal while inside the 

Upgrade all of your React dependencies manually

I'm not sure if it's just the fact that our version of Create React App is so outdated (it was running 

, after all), or if it is something to do with my computer, in particular, but after upgrading the 

, the React and React DOM versions in my 

Not to worry though, we can do it ourselves.

, and paste in the unit testing libraries you'll need.

Normally, in a new CRA project starting from scratch, these testing dependencies are included from the start. So we're including them, too, because they are the best options currently out there for automated testing of React apps.

Here are the additional dependencies we need to add or modify for our 

  "dependencies": {
    "@testing-library/jest-dom": "^5.11.6",
    "@testing-library/react": "^11.2.2",
    "@testing-library/user-event": "^12.2.2",

    "react": "^17.0.2",
    "react-dom": "^17.0.2",
    "react-router-dom": "^5.2.0",
    "react-scripts": "4.0.3",

 packages are all new, and you can manually update the existing 

A way to get all the correct package dependencies to go with the new react-scripts version

Unfortunately, there's no easy way to see what React versions go along with which versions of the 

, but I found a workaround, made a little easier by the fact we were upgrading to the latest version of React. It's hacky, but it works.

The solution? Make a sample project using the terminal command to spin up a new starter project.

Once the sample app's finished installing, you can open up the 

 packages, and any other new upgrades (like the 

Then, just make our project's dependencies match the one in the starter project's 

Double check the new React versions in the node_modules folder

Before we try to restart the app, it's worth doing a quick spot-check that the updated versions of React and the other new dependencies we added took effect.

 Confirm the updated dependencies by opening up the freshly installed 

 folder and checking a couple of key libraries that should have been updated.

The first dependency I want to ensure has been successfully upgraded are the 

If everything went as expected, you'll see the the version of this package is 4.0.3, like the image below.

Things are off to a good start. Let's check a few more packages.

 to see if it's running the latest React version. Here's what you should see to confirm the new version.

If you look closely at the image, you'll notice the React version here in the 

Finally, one last key dependency we can confirm is to make sure the newest version of Jest (part of our unit testing framework), v26, is present. Scroll back up in the 

 accompanying this library, and you should be able to confirm the version is 26.

---
title: 'Designing End-To-End Tests With Cypress.io's Studio Feature'
role: 'LESSON'
description: Before we can do anything else, we must upgrade our sample app's React version to start taking advantage of the advances.
privateVideoUrl: https://fullstack.wistia.com/medias/r9s2xikteh
isPublicLesson: false
code: https://gitlab.com/fullstackio/books/newline-course-apps/paige-niedringhaus-modernizing-an-enterprise-react-app-app/-/tree/main/code/module_03/lesson_03.01/protected/source_code/hardware-handler-2-begin?ref_type=heads
---

# Upgrade the React app version

Hooks weren't introduced until React v16.8.0, but our app is currently running v16.4.0. The first thing we have to do is upgrade the version of React our application is running.

**This lesson will walk through upgrading our app to use the latest version of React released to date.**

> If you were to attempt to add a hook to our app as it currently exists, you'd see an error in the browser's developer tools along the lines of:
>
> ```javascript
> Uncaught TypeError: Object(...) is not a function
> ```
>
> It's not a very helpful error message, but after a quick [Google search](https://stackoverflow.com/questions/53861645/react-hooks-issues-in-react-16-7-typeerror-object-is-not-a-function), you'll figure out a React version that doesn't work with hooks is the actual issue.

I> **Sample code zip file**
I>
I> If you need a fresh copy of the sample app _before_ we start to upgrade it, it's available **[here](http://localhost:3001/assets/protected/courses/newline-guide-to-modernizing-an-enterprise-react-app/module_03/lesson_03.01/protected/source_code/hardware-handler-2.zip)**.

### Create React app docs

Since we have an already existing Create React App, our path to upgrading is a little different than if we were starting from scratch with the most up-to-date version of React. Lucky for us, the [official Create React App docs](https://create-react-app.dev/docs/updating-to-new-releases/) have a fairly well-documented upgrade process.

#### Check the CRA changelog for the latest react-scripts version

**Step one:** Go to the [changelogs for the React Scripts](https://github.com/facebook/create-react-app/blob/master/CHANGELOG.md), and find the newest version of the react-scripts available.

I> At the time of writing this, the React Scripts are up to v4.0.3. They may be higher when you start — best to check the Create React App website.

If you scroll down past the initial notes of what new updates this version contains, you should see a section titled "Migrating from X.X.X to X.X.X".

Here are the npm and yarn commands we'll need to upgrade the `react-scripts`, which can then be used to update the React versions in our project.

Copy the yarn command (or npm, if that's your preference): `yarn add --exact react-scripts@4.0.3`, and paste it into your terminal while inside the `client/` folder of your application.

```shell
yarn add --exact react-scripts@4.0.3
```

#### Upgrade all of your React dependencies manually

I'm not sure if it's just the fact that our version of Create React App is so outdated (it was running `react-scripts: 1.1.4`, after all), or if it is something to do with my computer, in particular, but after upgrading the `react-scripts` dependency, deleting my `node-modules` in the `client/` folder, and re-running `yarn`, the React and React DOM versions in my `package.json` did not upgrade on their own.

Not to worry though, we can do it ourselves.

**Step two:** Manually update your `package.json`'s `"dependencies"` section to the new versions of `react` and `react-dom`, and paste in the unit testing libraries you'll need.

T> Normally, in a new CRA project starting from scratch, these testing dependencies are included from the start. So we're including them, too, because they are the best options currently out there for automated testing of React apps.

Here are the additional dependencies we need to add or modify for our `package.json`.

```json { actualFilename=./protected/source_code/hardware-handler-2-ending/client/package.json endLine=9 startLine=6 statedFilename=client/package.json url=https&#x3A;//gitlab.com/fullstackio/books/newline-guide-to-modernizing-an-enterprise-react-app/module_03/lesson_03.01/protected/source_code/hardware-handler-2-ending/client/package.json#L6 }
  "dependencies": {
    "@testing-library/jest-dom": "^5.11.6",
    "@testing-library/react": "^11.2.2",
    "@testing-library/user-event": "^12.2.2",
```

```json { actualFilename=./protected/source_code/hardware-handler-2-ending/client/package.json endLine=18 startLine=15 statedFilename=client/package.json url=https&#x3A;//gitlab.com/fullstackio/books/newline-guide-to-modernizing-an-enterprise-react-app/module_03/lesson_03.01/protected/source_code/hardware-handler-2-ending/client/package.json#L15 }
    "react": "^17.0.2",
    "react-dom": "^17.0.2",
    "react-router-dom": "^5.2.0",
    "react-scripts": "4.0.3",
```

Notice that the `@testing-library` packages are all new, and you can manually update the existing `react` and `react-dom` versions to `^17.0.2`. Then, delete your `node_modules` folder once more from the `client/` folder, and run `yarn` one more time.

> **A way to get all the correct package dependencies to go with the new react-scripts version**
>
> Unfortunately, there's no easy way to see what React versions go along with which versions of the `react-scripts`, but I found a workaround, made a little easier by the fact we were upgrading to the latest version of React. It's hacky, but it works.
>
> The solution? Make a sample project using the terminal command to spin up a new starter project.
>
> ```shell
> npx install create-react-app sample-app
> ```
>
> Once the sample app's finished installing, you can open up the `package.json` file and see the versions of the `react-scripts`, the corresponding `react` and `react-dom` packages, and any other new upgrades (like the `@testing-library` packages for testing).
>
> Then, just make our project's dependencies match the one in the starter project's `package.json`.

#### Double check the new React versions in the node_modules folder

Before we try to restart the app, it's worth doing a quick spot-check that the updated versions of React and the other new dependencies we added took effect.

**Step three:** Confirm the updated dependencies by opening up the freshly installed `node_modules` folder and checking a couple of key libraries that should have been updated.

**Check React Scripts are v4**

The first dependency I want to ensure has been successfully upgraded are the `react-scripts`. If you open the `node_modules` inside the `client/` folder, scroll down forever to the `react-scripts` and check the `package.json` file.

If everything went as expected, you'll see the the version of this package is 4.0.3, like the image below.

![screenshot of updated react-scripts version in the package.json dependencies](https://d2uusema5elisf.cloudfront.net/courses/newline-guide-to-modernizing-an-enterprise-react-app/module_03/lesson_03.01/public/assets/react-scripts-version.png)

Things are off to a good start. Let's check a few more packages.

**Check React is up to v17**

Next, let's find the `react` package in `node_modules` to see if it's running the latest React version. Here's what you should see to confirm the new version.

![screenshot of updated react version in the package.json dependencies](https://d2uusema5elisf.cloudfront.net/courses/newline-guide-to-modernizing-an-enterprise-react-app/module_03/lesson_03.01/public/assets/react-version.png)

If you look closely at the image, you'll notice the React version here in the `react` library itself is `"version": "17.0.2"`. Nice! That looks to be in order, too.

**Check Jest testing library is v26**

Finally, one last key dependency we can confirm is to make sure the newest version of Jest (part of our unit testing framework), v26, is present. Scroll back up in the `node_modules` folder to the `jest` package. Open up the `package.json` accompanying this library, and you should be able to confirm the version is 26.

![screenshot of updated jest version in the package.json dependencies](https://d2uusema5elisf.cloudfront.net/courses/newline-guide-to-modernizing-an-enterprise-react-app/module_03/lesson_03.01/public/assets/jest-version.png)