GlobeScout

GlobeScout is a React application that provides information about countries around the world. It allows users to search for countries, filter them by region, and view detailed information about each country.

Table of Contents

• Features
• Installation
• Usage
• Technologies
• Contributing
• License

Features

• Search: Search for countries by name.
• Filter: Filter countries by region.
• Pagination: Navigate through the list of countries with pagination.
• Country Details: View detailed information about each country, including population, region, and capital.

Installation

1. Clone the repository:

   git clone https://github.com/adarshlkdev/globescout.git
   cd globescout

2. Install the dependencies:

   npm install

3. Start the development server:

   npm run dev

   The application will be available at http://localhost:3000.

Usage

• Use the search bar to find countries by name.
• Use the filter dropdown to filter countries by region.
• Click on a country card to view detailed information about the country.
• Use the pagination controls to navigate through the list of countries.

Technologies

• React 18: A JavaScript library for building user interfaces.
• React Router: For routing and navigation.
• Axios: For making HTTP requests to fetch country data.
• React Icons: For using icons in the application.
• CSS: For styling the application.

Contributing

Contributions are welcome! Please follow these steps to contribute:

1. Fork the repository.
2. Create a new branch (git checkout -b feature/your-feature).
3. Make your changes.
4. Commit your changes (git commit -m 'Add some feature').
5. Push to the branch (git push origin feature/your-feature).
6. Open a pull request.

License

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