🌍 Global GDP Dashboard 📈

Unlock the world's economic pulse. A blazing-fast, interactive web application built with Streamlit that beautifully visualizes the Gross Domestic Product (GDP) of countries around the globe.

---

✨ Why this Dashboard?

Economic data shouldn't be trapped in boring spreadsheets. This dashboard transforms raw World Bank/IMF data into rich, interactive stories. Whether you're a data science enthusiast, an economics student, or a developer looking for a solid Streamlit template, this project provides a stunning baseline.

📊 Powerful Visualizations

This dashboard doesn't just show numbers; it makes them make sense. Dive deep into the data with:

• 🗺️ Choropleth Maps: See the global distribution of wealth at a glance with interactive color-coded world maps.
• 📈 Time-Series Line Charts: Track the economic growth (or decline) of specific nations over decades to spot historical trends.
• 📊 Comparative Bar & Column Charts: Stack countries side-by-side to compare current economic powerhouses against emerging markets.
• 🥧 Distribution Donut Charts: Understand the percentage share of global GDP held by top economies.

🚀 Quick Start

Get this dashboard running on your local machine in seconds!

Prerequisites

Make sure you have Python 3.8+ installed on your system.

Installation

1. Clone the repository:

   git clone https://github.com/aryangup451-del/gdp-dashboard.git
   cd gdp-dashboard

2. Install the dependencies: (It's recommended to use a virtual environment)

   pip install -r requirements.txt

3. Fire it up:

   streamlit run app.py

   The dashboard will automatically open in your default web browser at http://localhost:8501.

---

🛠️ Built With

• Streamlit: The fastest way to build and share data apps.
• Pandas: For robust data manipulation and cleaning.
• Plotly / Altair: For rendering buttery-smooth, interactive graphs.

💡 How to Customize

Since this is a template, you can easily swap out the dataset!

1. Replace the existing CSV/data source in the data/ folder.
2. Update the dataframe loading logic in app.py.
3. Tweak the chart configurations to match your new data dimensions.

🤝 Contributing

Contributions, issues, and feature requests are always welcome! If you want to make this dashboard even crazier (add forecasting models, new map projections, or real-time API integrations), feel free to fork the repo and submit a Pull Request.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

📝 License

Distributed under the MIT License. See LICENSE for more information.