How To Setup Continuous Integration (CI) With React, CircleCI, and GitHub

How To Setup Continuous Integration (CI) With React, CircleCI, and GitHub

To ensure the highest grade of quality code, we need to run multiple checks on each commit/pull request. Running code checks is especially useful when you’re working in a team, and making sure everyone follows the best and latest practices.

What kind of checks are we talking about? For starters, running our unit tests to make sure everything passes, building and bundling our front end to make sure the build won’t fail on production, and running our linters to enforce a standard.

At my current company, we run many checks before any code can be committed to the repository.

Code checks at Newly

CI lets us run code checks automatically. Who wants to run all those commands before pushing code to the repository?

Getting Started

I’ve chosen CircleCI because of its generous free tier, GitHub because of its community, and React because it’s easy and fun to use.

Create React App

Create your React app to your liking. For simplicity’s sake, I’m using CRA.

Create GitHub Repository

Once you’re finished with CRA, push the code to your GitHub repository.

Setting Up CI With CircleCI

If you already have a CircleCI account, great! If not, create one here.
Once you’ve logged in, click on Add Projects.

Adding a Project to CircleCI

Find your repository and click Set Up Project.

Setting up a project
Now we should see some instructions.

Simple enough, let’s create a folder called .circleci, and place the config.yml inside the folder.

We specify the CircleCI version, orbs, and workflows. Orbs are shareable configuration packages for your builds. A workflow is a set of rules for defining a collection of jobs and their run order.

Push the Code to Your Repository

Start building

Head back to CircleCI and press Start building.

If you click on the build, you can monitor what actually happened. In this case, the welcome orb is a demo and doesn’t do much.

Setting Up CircleCI With React

Use config.yml setup to run test, lint and build checks with React.

After you’ve pushed this code, give the orb the permissions it needs.

Settings -> Security -> Yes, allow orbs

Each commit/PR now runs the workflow jobs.

Check CircleCI for the progress of the jobs. Here’s what CircleCI is doing for each commit:

  • Set up the React project.
  • Runs ESLint to check the formatting of the code.
  • Runs unit tests.
  • Runs test coverage.

All of the workflow jobs above have to succeed for the commit and build to be successful.

Each commit now has a green, red or yellow tick indicating the status! Handy.

If you’re curious to learn more about the best practices for security, scalability, and dev ops, start from this book.

You can find the source code repository here.

Thanks for reading! Stay awesome.

Your browser is out-of-date!

Update your browser to view this website correctly. Update my browser now