Skip to content

iam-salma/crisis-news-tracker

Repository files navigation

gitlogo

Crisis Aid – Real-time News and Awareness Hub

Stars Forks Issues Pull Requests Last Commit

CrisisAid is more than just a news site — it's your real-time window into global emergencies, designed to inform, support, and spark action when it matters most.

Built with a powerful full-stack setup, CrisisAid pulls in live crisis updates from around the world using trusted public APIs. These updates are then brought to life on an interactive world map 🌐 with geo-tagged markers, country filters, and verified donation links 💸 — so you're never just a bystander.

Whether you're tracking events, sharing updates, or looking to help, CrisisAid gives you:

🗺️ A global crisis map (thanks to Leaflet.js)

📬 A newsletter to stay in the loop

🧠 A clean and responsive UI that actually feels good to use

On the backend, it's powered by FastAPI + Flask for lightning-fast data delivery, and built to scale — just like the impact we’re aiming for.

Join us in turning awareness into action ⚡.

💡 Key Features:

🔄 Real-time crisis news aggregation

🌍 Interactive world map with geo-tagged popups

✅ Verified donation links for direct relief

📨 Country filter & newsletter subscription

⚙️ SQLite backend with FastAPI and Flask APIs

🧠 Designed with scalability and impact in mind

🔧 Setup Steps :

  1. 📥 Clone the repository :

    git clone https://github.com/iam-salma/crisis-news-tracker.git
    cd crisis-news-tracker
  2. 🐍 Make sure you have Python 3 installed. :

    Here’s the official link to install Python 3: 🔗 https://www.python.org/downloads/

  3. 📦 Create a virtual environment :

    python -m venv venv
  4. ⚙️ Activate the virtual environment

    On Windows :

    .\venv\Scripts\activate

    On macOS/Linux :

    source venv/bin/activate
  5. 📌 Install dependencies :

    pip install -r requirements.txt
  6. 🗝️ Create .env folder to store secrets : refer the .env.example for reference

  7. 📂 Delete the instance/ folder : create it again and add news.db file in the folder

  8. 🏃To Run the Project:

    uvicorn main:app --reload

🌐 Live Demo

👉 Click here to view the deployed website

ENJOY 😊🎉