A ReactJS app to harvest a REST API. Built with hooks and unit test.
Find a file
2019-07-25 23:45:01 -04:00
public Initial commit. 2019-06-23 16:41:35 -04:00
src Team tests (ongoing) 2019-07-25 23:45:01 -04:00
.eslintignore Tests for Member.jsx 2019-07-17 00:14:21 -04:00
.eslintrc Team tests (ongoing) 2019-07-25 23:45:01 -04:00
.gitignore Initial commit. 2019-06-23 16:41:35 -04:00
.prettierrc Tests for Member.jsx 2019-07-17 00:14:21 -04:00
LICENSE Readme and license 2019-06-28 01:53:57 -04:00
package-lock.json Tests for Member.jsx 2019-07-17 00:14:21 -04:00
package.json Tests for Member.jsx 2019-07-17 00:14:21 -04:00
README.md Readme and license 2019-06-28 01:53:57 -04:00

Tempo challenge

A React app to harvest Tempo's team REST service.

Challenge

  • Build a UI showing an overview of all the teams, and allow the current user to navigate between teams to see each team's members.
  • At the top of the teams overview page, add an input field, which filters the teams when the input value changes. This input field could also be used in other pages of your app, e.g. for filtering out team members in the team page.

Solution

The end points of Tempo's REST API provide segmented info of their teams and members. In order to display all information I structured the app into 3 levels:

  1. A Home view with all teams
  2. A Team view with all members of a selected team
  3. A Member view with the info of a selected member

This structure allows some segmentation of the API calls. For example, the call for a member's inf can be made only when the third view is loaded. But there is still a lot of information still must me loaded in the Home view and passed forward to other views.

As the app is small, I chose not to implement Redux, Redux-Saga nor similar solutions. Instead, I used react-router v4 with a structure to manage the transfer of props between components.

This choice favors simplicity and fits quite well for small applications, specially when using React Hooks, as is the case.

Bigger applications would obviously make harder to track the passage of props between components, at which point it would be useful to implement a store to be the single source of truth for all the views of the app.

This project was bootstrapped with Create React App.

App structure

The 3 main views cited above are stored in src/views.

The src/components holds the input field that filters results. It is used from the Home and the Team views. It also has a team list component.

The all-mighty router is in src/components.

.
├── public
│   ├── favicon.ico
│   ├── index.html
│   └── manifest.json
├── src
│   ├── components
│   │   ├── FilterForm.jsx
│   │   ├── FilterForm.scss
│   │   ├── Router.jsx
│   │   └── TeamList.jsx
│   ├── views
│   │   ├── Home.jsx
│   │   ├── Home.scss
│   │   ├── Member.jsx
│   │   ├── Member.scss
│   │   ├── Team.jsx
│   │   └── Team.scss
│   ├── App.js
│   ├── App.scss
│   ├── App.test.js
│   ├── config.json
│   ├── history.js
│   ├── index.css
│   ├── index.js
│   └── serviceWorker.js
├── LICENSE
├── README.md
├── package-lock.json
├── package.json
└── yarn.lock

4 directories, 26 files

Requirements

Node JS and npm.

Installation

Clone this repository

git clone https://github.com/Rodrigoplp/tempo-rest-client.git

Install dependencies

npm install

Start the app

npm start

Open a browser and access http://localhost:3000.