• HTML
  • CSS
  • JS
  • API

REST Countries API with color theme switcher


Download Includes

  • JPEG design files for mobile & desktop layouts
  • Optimized assets
  • README file to help you get started
  • Style guide for fonts, colours, etc
  • HTML file with pre-written content
  • Sketch design file - Buy Now
Sketch app logo

Download Sketch File

Want to try and build pixel-perfect projects? The free download comes with JPEG design files, but you can purchase the original Sketch design file here. This will give you access to the exact design details you need to build the best solution possible.

Buy Now ( ... )



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

You can use any JavaScript framework/library on the front-end such as React or Vue. 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
  • Click through to the border countries on the detail page
  • Toggle the color scheme between light and dark mode (optional)

Download the starter code and go through the README.md file. This will provide further details about the project. The style-guide.md file is where you'll find colors, fonts, etc.

Want some support on the challenge? Join our Slack community and ask questions in the help channel.

Getting started

  1. Download the starter code
  2. Choose a JS framework/library and create your project

  3. Set up the project with version control (e.g. Git)

  4. Read the README.md file and have a look around the starter files

  5. Get colors, fonts etc from the style-guide.md file

  6. Set up your project/file architecture however you want

  7. Start coding!

Ideas to test yourself

  • Write your styles using a pre-processor, such as Sass, Less, Stylus or use a CSS-in-JS solution, like Styled Components

  • Try using Flexbox and Grid for layout

  • Practice working in a team by building with friends


Slack logo

Join our Slack community

Join over 15,000 people taking the challenges, talking about their code, helping each other, and chatting about all things front-end!