Osun State Flood Alert System

A web application that allows residents of Osun State, Nigeria to receive early flood warnings based on weather forecasts.

Features

  • User authentication (signup and login)
  • Location management for Osun State areas
  • Flood prediction system (2 weeks in advance)
  • Email notifications for flood alerts

Project Structure

  • /backend - Server-side code and API endpoints
  • /frontend - User interface and client-side code
  • /shared - Shared types and utilities

Technologies

  • Backend: Hono (TypeScript)
  • Database: SQLite
  • Frontend: HTML, JavaScript, Tailwind CSS
  • Weather Data: Open-Meteo API
  • Notifications: Email

How It Works

  1. Users sign up with their email and basic details
  2. After login, users can add their location within Osun State
  3. The system checks weather forecasts daily for potential flooding
  4. If flooding is predicted in the next 2 weeks, users receive email notifications