https://github.com/bocaletto-luca/country-explorer
Country Explorer is an interactive web application that empowers you to discover countries from around the world using free public APIs. With advanced filtering options by continent, the app displays each nation's name, flag, detailed information—including population statistics—and offers interactive charts to visualize population data. Whether ...
https://github.com/bocaletto-luca/country-explorer
api application bocaletto-luca countries countries-api country css3 database free-api html5 javascript opensource responsive webapp
Last synced: about 1 month ago
JSON representation
Country Explorer is an interactive web application that empowers you to discover countries from around the world using free public APIs. With advanced filtering options by continent, the app displays each nation's name, flag, detailed information—including population statistics—and offers interactive charts to visualize population data. Whether ...
- Host: GitHub
- URL: https://github.com/bocaletto-luca/country-explorer
- Owner: bocaletto-luca
- License: gpl-3.0
- Created: 2025-05-28T11:03:19.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-05-28T11:08:35.000Z (about 1 year ago)
- Last Synced: 2025-05-28T12:21:19.468Z (about 1 year ago)
- Topics: api, application, bocaletto-luca, countries, countries-api, country, css3, database, free-api, html5, javascript, opensource, responsive, webapp
- Language: HTML
- Homepage: https://bocaletto-luca.github.io/
- Size: 26.4 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Country Explorer | API Free | Database | WEBAPP
#### Author: Bocaletto Luca
[](https://developer.mozilla.org/en-US/docs/Web/HTML) [](https://developer.mozilla.org/en-US/docs/Web/CSS) [](https://developer.mozilla.org/en-US/docs/Web/JavaScript) [](https://getbootstrap.com/) [](https://www.chartjs.org/)
Country Explorer is an interactive web application that empowers you to discover countries from around the world using free public APIs. With advanced filtering options by continent, the app displays each nation's name, flag, detailed information—including population statistics—and offers interactive charts to visualize population data. Whether you're a geography enthusiast or a data lover, Country Explorer provides a comprehensive view of global demographics in a sleek, responsive interface.
## Features
- **Responsive Design:** Enjoy a seamless experience across desktops, tablets, and mobile devices.
- **Free API Integration:** Fetch real-time country data using public APIs (e.g., the REST Countries API).
- **Continent Filtering:** Sort and filter countries by continent for targeted exploration.
- **Country Details:** View essential information such as the country's name, flag, capital, region, population, and more.
- **Interactive Population Charts:** Visualize population data with dynamic charts powered by Chart.js.
- **User-Friendly Interface:** An intuitive layout makes it easy to navigate and explore global nations.
## Technologies Used
- **HTML5**
- **CSS3**
- **JavaScript**
- **Bootstrap 5**
- **Chart.js**
## Getting Started
### Prerequisites
Country Explorer runs in modern web browsers and does not require additional dependencies. For development purposes, it is recommended to use a code editor with live reload functionality (such as Visual Studio Code with the Live Server extension).
### Installation
1. **Clone the Repository**
git clone https://github.com/bocaletto-luca/country-explorer.git cd country-explorer
2. **Launch the Application**
- Open the `index.html` file in your preferred web browser.
- Alternatively, use a live reload server via your code editor to preview changes in real time.
## How It Works
- **Data Fetching:** The application uses JavaScript's Fetch API to retrieve country data from free public APIs (like the REST Countries API). The JSON response is parsed to create dynamic and informative country cards.
- **Filtering by Continent:** Users can sort and filter countries by selecting a specific continent, which updates the displayed results accordingly.
- **Country Details Display:** Each country card shows key details including the country's name, flag, capital city, region, and population.
- **Interactive Population Charts:** Leveraging Chart.js, the app renders interactive charts that visually represent population data, helping users gain insights into demographic trends.
- **Responsive UI:** With Bootstrap 5 and custom CSS, Country Explorer adapts seamlessly to any device, ensuring a smooth and engaging experience.
## Contributing
Contributions are welcome! If you'd like to suggest improvements or add new features, please follow these steps:
1. Fork the repository.
2. Create a new branch for your feature or fix:
3. Open a Pull Request against the main branch of the original repository.
## License
This project is licensed under the **GNU General Public License v3.0 (GPLv3)**. See the [LICENSE](LICENSE) file for additional details.
## Contact
For questions, suggestions, or feedback, please open an issue in this repository or contact the maintainer via GitHub.
#### Enjoy WEBAPP - By Bocaletto Luca