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

https://github.com/oscarfmdev/countries-info

Countries Info is a Single Page Application, the user can search for countries and click on any flag to know more about this country.
https://github.com/oscarfmdev/countries-info

api-rest react redux

Last synced: about 2 months ago
JSON representation

Countries Info is a Single Page Application, the user can search for countries and click on any flag to know more about this country.

Awesome Lists containing this project

README

          

logo

Microverse README Template

# πŸ“— Table of Contents

- [πŸ“– About the Project](#about-project)
- [πŸ›  Built With](#built-with)
- [Tech Stack](#tech-stack)
- [Key Features](#key-features)
- [πŸš€ Live Demo](#live-demo)
- [πŸ’» Getting Started](#getting-started)
- [Setup](#setup)
- [Prerequisites](#prerequisites)
- [Install](#install)
- [Usage](#usage)
- [Run tests](#run-tests)
- [Deployment](#triangular_flag_on_post-deployment)
- [πŸ‘₯ Authors](#authors)
- [πŸ”­ Future Features](#future-features)
- [🀝 Contributing](#contributing)
- [⭐️ Show your support](#support)
- [πŸ™ Acknowledgements](#acknowledgements)
- [❓ FAQ](#faq)
- [πŸ“ License](#license)

# πŸ“– [Countries Info]

**[Countries Info]** is a Single Page Application, the user can search for countries and click on any flag to know more about this country.

## πŸ›  Built With

### Tech Stack

Client

Storage

API

### Key Features

- **Single Page Application**
- **The user can filter the countries and click to see more about the country.**
- **The app uses React and calls an API to get the information and store it using Redux**

(back to top)

## πŸš€ Live Demo

- [Live Demo Link](https://oscarfmdev-countries.netlify.app/)

## πŸš€ Video Demo

- [Live Video](https://www.loom.com/share/eaebc1690e674db085ed3b2ebeb1d763)

(back to top)

## πŸ’» Getting Started

To get a local copy up and running, follow these steps.

### Prerequisites

In order to run this project you need:

To have installed [node.js](https://nodejs.org/en/download/) and [Git](https://git-scm.com/downloads)

### Setup

Clone this repository to your desired folder:

First enter the folder you want to save the project.
```sh
cd my-folder
```
After moving into the directory you want to save the project you could clone it using the terminal.

```sh
git clone git@github.com:OscarFMdev/countries-info.git
```

### Install

Install this project with:

```sh
cd space-travelers-hub
npm install
```

### Usage

To run the project, execute the following command:

```sh
npm start
```

### Run tests

To run tests, run the following command:

```sh
npm run test
```

(back to top)

## πŸ‘₯ Authors

πŸ‘€ **Author: Oscar FernΓ‘ndez MuΓ±oz**

- GitHub: [@OscarFMdev](https://github.com/OscarFMdev)
- Twitter: [@oscarfmdev](https://twitter.com/oscarfmdev)
- LinkedIn: [LinkedIn](https://linkedin.com/in/oscarfmdev)

(back to top)

## πŸ”­ Future Features

- [ ] **Update styling based on feedback.**
- [ ] **Add more information about each country.**

(back to top)

## 🀝 Contributing

Contributions, issues, and feature requests are welcome!

Feel free to check the [issues page](../../issues/).

(back to top)

## ⭐️ Show your support

If you like this project show your support giving a ⭐.

(back to top)

## πŸ™ Acknowledgments

I would like to thank:
- [Nelson Sakwa](https://www.behance.net/sakwadesignstudio) [for his design](https://www.behance.net/gallery/31579789/Ballhead-App-(Free-PSDs))
- [REST Countries API](https://restcountries.com/) for making this project possible.

(back to top)

## ❓ FAQ

- **How can I use this API?**

- You can use the search bar or scroll to find the country you're interested on learning more about and click on the flag to display the country's information.

- **Can I contribute to this Single Page Application?**

- For sure! I'm always happy to meet new developers, and I'd love to work together πŸ™Œ.

(back to top)

## πŸ“ License

This project is [MIT](./LICENSE) licensed.

(back to top)