Judhunja/afya-kenya-alerts

# AfyaApp - Health Alert System - afya-kenya-alerts.lovable.a… A health alert system for Kenya that allows users to register and receive SMS notifications about health outbreaks in their counties. ## 🏥 Features - User registration with name, email, phone number, and location - SMS notifications for health alerts by county - Real-time health alerts for Nairobi, Mombasa, and Kisumu - MongoDB database for user data storage - Africa's Talking SMS integration ## 🛠️ Technology Stack **Frontend:** - React 18 with TypeScript - Tailwind CSS for styling - Shadcn/ui components - React Router for navigation - Built with Lovable **Backend:** - Python Flask - MongoDB for database - Africa's Talking SMS API - Flask-CORS for cross-origin requests ## 🚀# 🚀 Quick Start ## Prerequisites - Python 3.8 or higher - Node.js 16 or higher - MongoDB (local or remote) - Africa's Talking API credentials (username and API key) ## Setup Instructions 1. **Clone the repository** ```bash git clone cd afya-kenya-alerts ``` ## Backend Setup ⚠️ **CRITICAL: Backend Must Run Separately** **Important**: Lovable only runs the frontend React app. You must run the Python Flask backend separately on your local machine or deploy it to a cloud service. 1. **Get Africa's Talking API Credentials First** Before setting up the backend, you **MUST** register for Africa's Talking: - Go to africastalking.com - Click "Sign Up" and create a free account - Verify your email and complete account setup - Login to your dashboard to get your credentials: - **Username**: Usually your email or a generated username - **API Key**: Found in the "API" section of your dashboard - **Add credits**: Purchase SMS credits to send messages (required for production) 2. **Install Python dependencies** ```bash cd backend python -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate pip install -r requirements.txt ``` 3. **Configure environment variables** Create a `.env` file in the backe …