SamuraWorks/MedFind-Salone

MedFind Salone allows users to search for hospitals and clinics, view essential details such as address, services offered, and contact information, check availability status, and access emergency contacts, all through a responsive, offline-capable interface designed to improve access to healthcare across Sierra Leone. # 🏥 MedFind Salone - Emergency Hospital Finder for Sierra Leone **Offline-first, life-saving mobile web application connecting Sierra Leoneans to emergency medical services** --- ## 📋 Table of Contents - Overview - Key Features - Live Demo - Project Structure - Installation & Setup - Technical Architecture - Hospital Dataset - API Documentation - User Flows - Offline Functionality - Multi-Language Support - For Judges & Evaluators - Roadmap - Contributing - License --- ## 🎯 Overview **MedFind Salone** addresses a critical challenge in Sierra Leone's healthcare system: **finding emergency medical services quickly, even without internet access.** ### The Problem - Limited access to real-time hospital information - Unreliable internet connectivity, especially in rural areas - No centralized database of hospital services and availability - Time wasted during medical emergencies searching for available facilities ### Our Solution A **progressive web application** (PWA) that: - ✅ Works 100% offline after initial data load - ✅ Uses GPS to find nearest hospitals with specific services - ✅ Provides real-time availability (beds, oxygen, surgeons, ambulances) - ✅ Supports both English and Krio languages - ✅ One-tap emergency calling and navigation - ✅ Admin panel for hospital staff to update availability --- ## ⚡ Key Features ### For Patients & Public #### 🚨 Emergency SOS Mode - **One-tap emergency access** to nearest hospital - **Auto-location detection** with fallback to manual entry - **Large, accessible buttons** for calling and navigation - **High-contrast red UI** for visibility in distress situations #### 🔍 Smart Search & Filtering - Search by hospital name, district, or services - Filter by: - Beds available - Oxygen availability - Surgeons on duty - Operating theatre status - Ambulance availability - District/region #### 🗺️ Dual View Modes - **List View**: Scrollable cards with …