Skip to content
Step 1: Start challenge
Free
  • HTML
  • CSS
  • JS
  • API
advanced

REST Countries API with color theme switcher

Build a countries app with search, filtering, detail pages, and a light/dark theme using any JS framework. Country data is provided as JSON.

Join 40,018 people who have taken this challenge

📝Brief

⚠️ Please note: this challenge no longer uses a live API. The REST Countries API it was built around has moved to a paid service, so we've included all the country data in a data.json file in the starter code for you to use instead. Working with it is very close to working with an API, so you'll still practice fetching, searching, filtering, and rendering the data.

Your challenge is to use the country data to build out the application and get it looking as close to the designs as possible.

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 fetch the data or style your project.

Your users should be able to:

  • See all countries from the data 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
  • View the optimal layout for the interface depending on their device's screen size
  • See hover and focus states for all interactive elements on the page
  • Bonus: Toggle the color scheme between light and dark mode

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 community and ask questions in the help channel.

🗃Assets provided

  • Figma design file access - Unlock with Pro
  • JPEG design files for mobile & desktop layouts
  • Style guide for fonts, colors, etc.
  • Optimized image assets
  • README file to help you get started
  • HTML file with pre-written content

💡Ideas to test yourself

  1. Write your styles using a pre-processor, such as Sass, Less or Stylus
  2. Train your eye for detail by getting your solution as close to the design as you can
  3. Try estimating the time it will take for you to build the project. Then see if the time taken matches up to your estimate. Project estimations are a skill that is often overlooked but is essential for professional developers

Challenge FAQs

  • How can I get help if I'm stuck on a challenge?

    The best (and quickest) way to get help on a challenge is in our Discord server. There are thousands of other developers in there, so it's a great place to ask questions. We even have a dedicated "help" channel! If you haven't joined yet, you can get an invite to our Discord server here.

  • How do I submit my solution?

    We'd recommend reading our complete guide to submitting solutions. If you get stuck and need help, please feel free to ask questions in our Discord server, and we'll help you submit your project.

  • Is there an official solution I can take a look at?

    We don't provide "official" solutions for the challenges. This is because there is no single perfect way to complete a challenge. Instead, you're encouraged to review other people's code in the community. You can learn so much by seeing how other people have approached the same challenges and giving them feedback.

  • Do I get a code review when I post my solution?

    Yes. You get an AI code review on one solution a month, or on every solution with Pro, and other solutions still get our automated code checks. The community can review your code too, so ask a specific question when you submit.

  • Can I use libraries/frameworks on these projects?

    Yes! Our challenges provide professional designs but there are no rules on what tools to use. So feel free to use anything you like to build your projects.

  • Should I use AI tools when working on challenges?

    Yes, once you've got the basics. We'd suggest hand-coding the early levels first, because you need to read code to check what an agent writes. Then you can build alongside an AI agent, or direct one. Whichever way you build, test each feature yourself before you submit, including with a keyboard and on a small screen.

  • Can I use these projects in my portfolio?

    Definitely! Please do feel free to use whatever you build in your portfolio. Helping developers add professional-looking projects to their portfolio was one of the reasons we created this platform!

  • How often are new challenges added?

    We aim to launch a new challenge every two weeks, with a mix of free and premium challenges.

  • What is the difference between the desktop-design, mobile-design, and desktop-preview images in my starter code?

    The desktop-design and mobile-design images show you how the layout should look at large and small screen sizes. The desktop design is 1440px wide, and the mobile design is 375px. However, try building projects to look good on all screen sizes. The desktop-preview image is a preview image used in the README file. You don't need to reference this while building the project.

  • Can I use these challenges within my own free or commercial content/tutorials/projects?

    Please visit our License page to learn more about how our challenges can be used within your own content. If you're unsure about anything, please feel free to contact us at [email protected] and we'll be more than happy to answer your questions.

Join our Discord community

Join thousands of Frontend Mentor community members taking the challenges, sharing resources, helping each other, and chatting about all things front-end!

Join our Discord