judeik/smarted-africa-app

📱 SmartEd Africa – A mobile-first learning platform empowering African students in IDP camps with AI tutors, localized lessons in Hausa, and teacher microlearning. Hackathon build (2025). # 🌍 SmartEd Africa App 📱 **SmartEd Africa – A mobile-first learning platform empowering African students with AI tutors, localized lessons, teacher microlearning, and offline learning for IDP camps.** --- ## 📌 Overview Millions of African students struggle with access to **quality education**, exam preparation (WAEC, JAMB, etc.), and modern learning resources. **SmartEd Africa App** bridges this gap by combining: - 🎓 **AI Tutors** for WAEC preparation - 🌍 **Localized lessons** in Hausa and other African languages - 📚 **Teacher microlearning modules** - 💾 **Offline-first learning** for IDP camps - 📱 **Mobile-first design** This repository contains the **hackathon build (Codefest Hack 2025, Nigeria)** of SmartEd Africa. --- ## 🛠️ Tech Stack - ⚡ **Frontend:** Vite + React + TypeScript - 🎨 **UI:** TailwindCSS + Bootstrap (combined for rapid prototyping + utility-first design) - 🔗 **Routing:** react-router-dom - 📦 **State Management:** Zustand (lightweight global store) - ⚙️ **Animation:** framer-motion - 🔐 **Authentication / HTTP:** axios + JWT-ready with mock demo login/signup - ⚙️ **Build & Code Tools:** ESLint + Prettier + Husky - 🧩 **Utilities:** class-variance-authority, tailwind-merge, tailwind-variants - 🤖 **AI/ML:** Python / TensorFlow / PyTorch - 🗄️ **Database:** PostgreSQL / MongoDB - 🛠️ **CI/CD:** GitHub Actions --- ## 🚀 Getting Started ### Prerequisites Make sure you have installed: - Node.js (v22+) - npm or yarn - Python (for AI/ML models) ### Clone the Repo ```bash git clone github.com cd smarted-africa-app ```bash ### Install Dependencies & Run Frontend: ```bash cd frontend npm install npm run dev ``` Backend: ```bash cd backend npm install npm run dev ``` AI/ML: ```bash cd ai-ml pip install -r requirements.txt ``` --- **Useful Scripts:** - npm run dev → start development server - npm run build → build project + TypeScript compilation - npm run lint → lint code and auto-fix - npm run for …