Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/lauragift21/fancy-countries

REST Countries API with color theme switcher
https://github.com/lauragift21/fancy-countries

Last synced: about 4 hours ago
JSON representation

REST Countries API with color theme switcher

Awesome Lists containing this project

README 

        
# Frontend Mentor - REST Countries API with color theme switcher



![Design preview for the REST Countries API with color theme switcher coding challenge](./design/desktop-preview.jpg)



## Welcome! 👋



Thanks for checking out this front-end coding challenge.



[Frontend Mentor](https://www.frontendmentor.io) challenges allow you to improve your skills in a real-life workflow.



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



## The challenge



Your challenge is to integrate with the [REST Countries API](https://restcountries.eu) 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](https://reactjs.org) or [Vue](https://vuejs.org). 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)*



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



## Where to find everything



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



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



The designs are in JPG static format. This will mean that you'll need to use your best judgment for styles such as `font-size`, `padding` and `margin`. This should help train your eye to perceive differences in spacings and sizes.



If you would like the Sketch file in order to see sizes etc, it is available to download from the challenge page on the site.



There are no assets for this challenge, as the country flags will be pulled from the [REST Countries API](https://restcountries.eu) and you can use an icon font library for the icons.



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



## Building your project



Practice using version control by creating your own GitHub repository for this challenge. This has the added benefit of being able to publish the site for free on GitHub Pages. Find out more about GitHub Pages here: [https://pages.github.com](https://pages.github.com).



Another great tool you could use to get your website live is [Netlify](https://www.netlify.com). They offer a very simple and intuitive way of deploying a site for free and linking the live version to your Git repository.



Also, you could try building this project in a team. This is a great way to practice collaborative coding.



## Suggested workflow



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](https://github.com/). This will make it easier to share your code with the community if you need some help. If you're not sure how to do this, [have a read through of this Try Git resource](https://try.github.io/).

2. Configure your repository to publish your code to [GitHub Pages](https://pages.github.com) or [Netlify](https://www.netlify.com).

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 that you could create to make 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.



## Sharing your solution



There are multiple places you can share your solution:



1. Submit it on the platform so that other users will see your solution on the site. Other users will be able to give you feedback, which could help improve your code for the next project.

2. Share your repository and live URL in the **#finished-projects** channel of the Slack community.

3. Tweet [@frontendmentor](https://twitter.com/frontendmentor) and mention **@frontendmentor** including the repo and live URLs in the tweet. We'd love to take a look at what you've built and help share it around.



## Giving feedback



Feedback is always welcome, so if you have any to give on this challenge please email hi[at]frontendmentor[dot]io.



This challenge is completely free. Please share it with anyone who will find it useful for practice.



**Have fun building!** 🚀