https://github.com/amruthlp12/nations-hub

Welcome to Nations Hub! This application allows users to explore information about all countries on Earth, providing a rich and interactive experience. Whether you're looking for general country information, detailed statistics, or just want to admire the flags of different nations, NationsHub has got you covered.
https://github.com/amruthlp12/nations-hub

nations-hub-app react react-api-project react-loader-spinner react-router-dom react-website reactjs responsive-web-design rest-api websit

Last synced: 9 months ago
JSON representation

Welcome to Nations Hub! This application allows users to explore information about all countries on Earth, providing a rich and interactive experience. Whether you're looking for general country information, detailed statistics, or just want to admire the flags of different nations, NationsHub has got you covered.

• Host: GitHub
• URL: https://github.com/amruthlp12/nations-hub
• Owner: AmruthLP12
• License: mit
• Created: 2024-02-01T10:18:31.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2025-06-23T04:22:43.000Z (12 months ago)
• Last Synced: 2025-06-23T05:21:03.113Z (12 months ago)
• Topics: nations-hub-app, react, react-api-project, react-loader-spinner, react-router-dom, react-website, reactjs, responsive-web-design, rest-api, websit
• Language: JavaScript
• Homepage: https://nations-hub.vercel.app
• Size: 2.06 MB
• Stars: 4
• Watchers: 1
• Forks: 2
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# 🌍 Nations Hub · [![Author Amruth L P](https://img.shields.io/badge/Author-Amruth-%3C%3E)](https://github.com/amruthlp12)

Welcome to Nations Hub! 🎉 Explore information about every country on Earth with our rich interactive experience. Discover stats, flags, and challenge yourself with geography games! 🌎✨

## ✨ Features

- **📚 Country Information:** Detailed stats including population, area, capital, languages, currency

- **🎌 Flag Gallery:** Comprehensive collection of national flags

- **🔍 Search Functionality:** Instantly find any country

- **🎮 Interactive Quiz Games:**

  - **🧭 Reach the Country:** Navigate through neighboring borders

  - **🗺️ Region Quiz:** Test your regional knowledge

  - **🌏 Sub-Region Quiz:** Match countries to sub-regions

  - **🏛️ Capital Quiz:** Identify countries by capitals

  - **💱 Currencies Quiz:** Match currencies to countries

  - **🗣️ Languages Quiz:** Identify official languages

- **📱 Responsive Design:** Works perfectly on all devices

## ⚙️ Tech Stack

- React.js

- HTML5

- CSS3

- JavaScript

- [REST Countries API](https://restcountries.com/)

## 🎮 Game Descriptions

### 🧭 Reach the Country

Start from a country and reach the destination through neighboring borders!  

![Reach the Country Game](/screenshots/reach-country.png)

### 🗺️ Region Quiz

Test your knowledge of world regions  

![Region Quiz](/screenshots/region-quiz.png)

### 🌏 Sub-Region Quiz

Match countries to their sub-regions  

![Sub-Region Quiz](/screenshots/subregion-quiz.png)

### 🏛️ Capital Quiz

Identify countries by their capitals  

![Capital Quiz](/screenshots/capital-quiz.png)

### 💱 Currencies Quiz

Match countries to their currencies  

![Currencies Quiz](/screenshots/currency-quiz.png)

### 🗣️ Languages Quiz

Identify countries by official languages  

![Languages Quiz](/screenshots/language-quiz.png)

## 🚀 Getting Started

Follow these steps to set up Nations Hub locally:

```bash

# Clone the repository

git clone https://github.com/amruthlp12/Nations-Hub.git

# Navigate to project directory

cd Nations-Hub

# Install dependencies

npm install

# Start the development server

npm start

```

The application should now be running on `http://localhost:3000`.

## 🌐 Live Demo

Check out the live demo of [Nations Hub](https://nations-hub.vercel.app/) to explore the features.

## 📸 Screenshots

### Country Information Page

![Country Information Page](/screenshots/country-info.png)

### Flag Gallery

![Flag Gallery](/screenshots/flag-gallery.png)

### Quiz Page

![Quiz Page](/screenshots/quiz-page.png)

### Reach the Country Game

![Reach the Country Game](/screenshots/reach-the-country.png)

### Normal Quiz

![Normal Quiz](/screenshots/normal-quiz.png)

## Contributing

Contributions are welcome! If you'd like to contribute to Nations Hub, please follow these guidelines:

1. Fork the repository.

2. Create a new branch (`git checkout -b feature/new-feature`).

3. Make your changes.

4. Commit your changes (`git commit -am 'Add new feature'`).

5. Push to the branch (`git push origin feature/new-feature`).

6. Create a new Pull Request.

## 👥 Contributors

- [@amruthlp12](https://github.com/amruthlp12) - Creator & Maintainer  

- [@Sanskargupta0](https://github.com/Sanskargupta0) - Quiz Game Features

## 🙏 Special Thanks

A big shoutout to [@Sanskargupta0](https://github.com/Sanskargupta0) for enhancing *Nations Hub* with engaging geography quizzes! 🧠🌍  

Your contributions made the app far more interactive and educational — we appreciate your awesome work! 💪✨

## License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

## Contact

Have any questions or suggestions? Feel free to contact us at [amruthlp12@gmail.com](mailto:amruthlp12@gmail.com).