Otigef/foodshare-kenya

Connect surplus food with those who need it most. Join Kenya's movement to end hunger and reduce food waste. # FoodShare Kenya 🍽️ A comprehensive web application for reducing food waste by connecting food donors with recipients in Kenya. Built with modern web technologies to facilitate efficient food distribution and community impact. ## 🌟 Features - **Food Donation Management**: Donors can post available food with details, quantities, and pickup locations - **Smart Food Discovery**: Recipients can browse available donations with filtering and search capabilities - **Real-time Alerts**: Custom food alerts notify users when specific food types become available - **Claims System**: Structured process for claiming donations with donor-recipient coordination - **Admin Dashboard**: Complete management system for users, donations, and claims - **Impact Tracking**: Visual analytics showing community impact and food waste reduction - **Role-based Access**: Secure authentication with donor, recipient, and admin roles - **Mobile-responsive**: Optimized for all devices and screen sizes ## 🚀 Quick Start ### Prerequisites - Node.js (v18 or later) - Install with nvm - npm or yarn package manager - Supabase account for backend services ### Installation 1. **Clone the repository** ```bash git clone github.com cd foodshare-kenya ``` 2. **Install dependencies** ```bash npm install ``` 3. **Environment Setup** ```bash cp .env.example .env ``` Update `.env` with your Supabase credentials: ```env VITE_SUPABASE_URL=your_supabase_project_url VITE_SUPABASE_ANON_KEY=your_supabase_anon_key ``` 4. **Database Setup** - Create a new Supabase project - Run the database migrations from `supabase/migrations/` - Enable Row Level Security (RLS) on all tables 5. **Start Development Server** ```bash npm run dev ``` The application will be available at `localhost` ## 🏗️ Technology Stack - **Frontend**: React 18, TypeScript, Vite - **Styling**: Tailwind CSS, shadcn/ui components - **Backend**: Supabase (PostgreSQL, Auth, Real-time) - **State …