daveontrack/shapethiopia-project

Full-stack humanitarian platform empowering communities across Ethiopia through donations, volunteer engagement, community development, and AI-powered solutions. # 🌍 SHAPEthiopia ### Sustainable Hope for Africa Program Ethiopia --- ## 🎨 Project Preview --- ## ✨ Overview **SHAPEthiopia** is a modern full-stack humanitarian platform built to empower communities across Ethiopia through scalable, technology-driven solutions. It connects **donors, volunteers, and organizations** in one unified ecosystem to drive sustainable social impact. --- ## 🎯 Mission To create lasting impact by supporting: - 📚 Education access - 💧 Clean water initiatives - 👩 Women empowerment - 🏘 Community development --- ## 🚀 Core Features ### 👤 User Experience - 🔐 Secure authentication (Email & Google OAuth) - 💳 Multi-channel donation system - Stripe (International) - Telebirr & CBE (Local) - 📊 Personalized dashboard - 🧾 Donation history tracking - 🙋 Volunteer application system --- ### 🛠 Admin Capabilities - 📈 Analytics & reporting - 💰 Donation approval system - 👥 Volunteer management - 🔔 Notifications system - 🔐 Role-Based Access Control (RBAC) --- ### 🤖 AI-Powered Features - 💬 AI chatbot assistant - 📉 Donation prediction insights - ✍️ Content optimization --- ## 🧠 Technology Stack ### Frontend - Next.js (App Router) - React.js - Tailwind CSS - shadcn/ui ### Backend - Node.js API Routes ### Database - Supabase (PostgreSQL) ### Integrations - Stripe (Payments) - SendGrid (Emails) - OpenAI API --- ## 🏗 System Architecture graph TD; User --> Frontend Frontend --> Supabase Frontend --> Stripe Frontend --> OpenAI shape-ethiopia/ ├── app/ ├── components/ ├── lib/ ├── api/ ├── public/ └── styles/ ``` ⚙️ Getting Started 1. Clone the repository ``` git clone github.com cd shapeeeeti ``` 2. Install dependencies ``` pnpm install ``` 3. Setup environment variables ``` .env.local: NEXT_PUBLIC_SUPABASE_URL= NEXT_PUBLIC_SUPABASE_ANON_KEY= STRIPE_SECRET_KEY= SENDGRID_API_KEY= OPENAI_API_KEY= ``` 4. Run the development server pnpm dev ``` ``` 📊 Database Overview Main tables: users dona …