Gregory-Hawman / exercismHiring

Exercism Frontend Developer Job: Project

Thanks for wanting to apply for the Frontend Developer Job role! 🥳

We're expecting a high number of applicants for this role, and so are asking everyone to submit an implementation of a programming challenge that will allow you to demonstrate your CSS and React skills.

The instructions are below. If you have questions, you can ask them by opening an issue in this repository (the preferred method), or you can email [e-mail] (emails will have a slower response time than opening issues). Once you're done, please follow the instructions in the job advert to apply. Good luck! 🙂

Overview

Your task is to create a page which lists all the testimonials you have given. It should look like this:

Styling

A key criteria for this job role is how accurately you can replicate designs. You can access the Figma file with all the information you should need at https://www.figma.com/file/qvDOfGC4uLDUcjRDaVMIrU/Exercism-Front-end-Job-Project?node-id=0%3A1 (note: you need to be logged into Figma to see the comments). Note the comments on various components for more information.

Ideally, you'll use Tailwind 3 for the CSS, but plain CSS is totally fine too.

Functionality

The functionality should be implemented using React. Ideally, you'll use TypeScript, but JavaScript is fine too.

Please provide some tests as well.

The areas that should be implemented are:

• Track selection:
  • Clicking the track button (top-left) should open the track selector.
  • Clicking on a track within the track selector should update the table accordingly and close the selector.
  • The tracks should be filtered to only show the list of tracks on which you have given testimonials.
• Exercise filtering:
  • Typing into the exercise box should filter the tracks.
  • Consider reducing calls to the API while the user is still typing.
• Sorting:
  • There are two sort options: oldest first or newest first.
• Pagination:
  • Pagination should be implemented.
  • Filtering should update pagination options (i.e. if there are only two pages of Ruby results then the pagination should only show two pages).

Other notes:

• All filtering of the testimonials should be done at the server-side level via API calls.
• You are not expected to implement the functionality of the top-bar.

API Calls

To get data you can use Exercism's API. There are two endpoints, both which return JSON and neither of which need authentication:

Tracks

You can retrieve the list of all tracks from: https://exercism.org/api/v2/tracks

Testimonials

Access the testimonials from: https://exercism.org/api/v2/hiring/testimonials

You can use the following params to modify which records are returned:

• page: Specify to return a different page (e.g. 2) of the results (note: page 1 is the first page).
• track: Pass a complete track slug (e.g. python) to only return the Ruby track's testimonials.
• exercise: Pass a partial exercise name (e.g. ming) to only return the exercises that contain the word "ming".
• order: Specify either newest_first or oldest_first (default) to switch the order.

A complete URL might be https://exercism.org/api/v2/hiring/testimonials?page=2&track=python&exercise=ming&order=newest_first.

The endpoint returns JSON with two top-level keys:

• testimonials: An object containing information related to the page of testimonials that is to be rendered.
  • results: The testimonials containing the relevant information to render on the UI.
  • pagination: Pagination data to allow you to render the pagination section.
  • tracks: A list of all tracks that this user has given testimonials on.