Skip to content

Your challenge is to integrate with the REST Countries API to pull country data and display it like in the designs.

Notifications You must be signed in to change notification settings

MarinaAlber/RestCountries

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

35 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Zyda Frontend Test - REST Countries API with color theme switcher

Design preview for the REST Countries API with color theme switcher coding challenge

Welcome! 👋

Thanks for checking out this front-end coding task.

To do this task, you need a good understanding of JavaScript.

The challenge

Your challenge is to integrate with the REST Countries API to pull country data and display it like in the designs.

Please use React JavaScript framework/library or Next.js React framework. You also have complete control over which packages you use to do things like make HTTP requests or style your project.

Your users should be able to:

  • See all countries from the API on the homepage
  • Search for a country using an input field
  • Filter countries by region
  • Click on a country to see more detailed information on a separate page (Country details page)
  • Click back button to return to countries page from the details page
  • Toggle the color scheme between light and dark mode (optional)

Where to find everything

Your task is to build out the project to the designs inside the /design folder.

In this task, you will find mobile and desktop designs in light and dark mode color schemes for both pages.

The designs are in JPG static format. Using JPGs will mean that you'll need to use your best judgment for styles such as font-size, padding and margin.

There are no assets for this task, as the country flags will be pulled from the REST Countries API and you can use an icon font library for the icons.

There is also a style-guide.md file containing the information you'll need, such as color palette and fonts.

Building your project

Feel free to use any workflow that you feel comfortable with. Below is a suggested process, but do not feel like you need to follow these steps:

  1. Initialize your project as a public repository on GitHub by forking this repo. Creating a repo will make it easier to share your code with us.
  2. Configure your repository to publish your code to a web address. This will also be useful if you need some help during a task as you can share the URL for your project with your repo URL. There are a number of ways to do this, and we provide some recommendations below.
  3. Look through the designs to start planning out how you'll tackle the project. This step is crucial to help you think ahead for CSS classes to create reusable styles.
  4. Before adding any styles, structure your content with HTML. Writing your HTML first can help focus your attention on creating well-structured content.
  5. Write out the base styles for your project, including general content styles, such as font-family and font-size.
  6. Start adding styles to the top of the page and work down. Only move on to the next section once you're happy you've completed the area you're working on.

Deploying your project

As mentioned above, there are many ways to host your project for free. Our recommend hosts are:

You can host your site using one of these solutions or any other trusted provider.

Create a custom README.md

We strongly recommend overwriting this README.md with a custom one. We've provided a template inside the README-template.md file in this starter code.

The template provides a guide for what to add. A custom README will help you explain your project and reflect on your learnings. Please feel free to edit our template as much as you like.

Once you've added your information to the template, delete this file and rename the README-template.md file to README.md. That will make it show up as your repository's README file.

Have fun building! 🚀

About

Your challenge is to integrate with the REST Countries API to pull country data and display it like in the designs.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 65.5%
  • SCSS 28.1%
  • HTML 6.4%