README.md

CountryInfo iOS App

Welcome to CountryInfo, an iOS application designed to provide users with information about various countries around the world. This app utilizes the sample API from Sample APIs to fetch details such as country name, flag, population, currency, and capital.

Preview

Note Please clone this repository and run it in the simulator to experience the animation and interactive UI firsthand, as the video compression may have affected the quality of the visuals.

compresed_recording.mp4

Features

• View a list of countries along with their flag, population, currency, and capital.
• Search for a specific country by name.
• Filter country by using the population filter.

Installation

1. Clone or download the repository from GitHub.
2. Open the project in Xcode.
3. Build and run the project on a simulator.

Usage

• Upon launching the app, you will see a list of countries.
• Scroll through the list to view basic information such as the flag, population, currency, and capital.
• Use the search bar to find a specific country by name.

Requirements

• Xcode 15 or later
• iOS 17.0 or later
• Internet connection

API Documentation

• The API used for fetching country information is available at Sample APIs.
• Endpoint: https://api.sampleapis.com/countries/countries
• This endpoint returns a JSON array containing information about various countries including name, flag, population, currency, and capital.

Contributing

Contributions are welcome! If you'd like to enhance this app or fix any issues, feel free to submit a pull request.

License

This project is licensed under the MIT License. See the LICENSE file for details.

---

Enjoy exploring CountryInfo! If you have any questions or feedback, please don't hesitate to get in touch. Thank you for using our app!