MahmoudGamal-AI/Haya-Karima

An advanced GeoAI interactive platform showcasing the impact of the "Haya Karima" (Decent Life) rural development initiative in Qena, Egypt. Features 3D maps, real-time data analysis, and interactive dashboards to track over 120 developmental projects serving 1.5 million citizens. Built with React, Vite, Tailwind CSS, and Mapbox. # 🇪🇬 Haya Karima - Qena | Rural Development GeoAI Platform An advanced interactive platform showcasing the impact of the **Haya Karima (Decent Life)** initiative in the Qena Governorate, utilizing Geospatial Artificial Intelligence (GeoAI) techniques for data analysis and visualization. The platform provides 3D maps, real-time data, and interactive dashboards to track over 120 developmental projects serving approximately 1.5 million citizens across 86 villages in Upper Egypt. ## 🌟 Key Features - **🌍 3D Maps:** Accurate geographical representation of villages and districts in Qena using Mapbox GL. - **📊 Interactive Dashboard:** Live statistics and smart charts powered by Recharts to illustrate project completion rates. - **🧠 GeoAI Analysis:** Geospatial AI techniques to analyze spatial data and provide deep insights into rural development. - **🌓 Modern UI/UX:** Professional design supporting both Dark and Light modes, built with TailwindCSS and Radix UI. - **⚡ High Performance:** Fast and responsive Single Page Application (SPA) built with React.js and Vite. - **📱 Fully Responsive:** Perfectly supports all devices and screen sizes. ## 🛠️ Tech Stack - **Frontend Framework:** React 18 - **Build Tool:** Vite 6 - **Styling:** Tailwind CSS 4, Radix UI (Shadcn) - **Maps & GeoAI:** Mapbox GL, React Map GL, Turf.js - **Animations:** Framer Motion - **Data Visualization:** Recharts - **Icons:** Lucide React, MUI Icons ## 🚀 Getting Started ### Prerequisites - Node.js (Version 18 or higher) - npm, yarn, or pnpm ### Installation Steps 1. **Clone the repository:** ```bash git clone github.com cd Haya-Karima ``` 2. **Install dependencies:** ```bash npm install # or yarn install ``` 3. **Start the development server:** ```bash npm run dev ``` *The project will be running at: `localhost`* 4. **Build the project for production:** ```bash npm run build ``` ## 📁 Project Structure ```text Haya-Karima/ ├── public/ …