ManDeAcero/English-Somali-Learning-for-Love

# 🌍 Somali Learning PWA A culturally-sensitive progressive web app for learning Somali language, featuring authentic pronunciation, gamified progression, and respectful cultural guidance. ## ✨ Features ### 🎯 **Learning Experience** - **Authentic Somali vocabulary** from basic greetings to romantic expressions - **Google Text-to-Speech integration** with speed controls (Normal, Slow, Ultra Slow) - **English phonetic transcriptions** designed for English speakers - **Cultural sensitivity system** with respect guidelines for romantic content - **Progressive tier unlocking** based on points and cultural acknowledgment ### 🎮 **Gamification** - **Level progression** with points, streaks, and badges - **Interactive quizzes** with multiple choice questions - **Favorites system** with quiz mode for saved words - **Achievement badges** for learning milestones ### 🔊 **Pronunciation Help** - **Comprehensive pronunciation guide** with vowel/consonant breakdowns - **Individual word help** with common mistake warnings - **Sound pattern explanations** (e.g., "ca" = "kah", not "cat") - **Audio generation** with real Somali pronunciation ### 📱 **PWA Features** - **Offline functionality** with service worker caching - **Mobile-first responsive design** - **Install as native app** on mobile and desktop - **Anki export** for flashcard integration ## 🏗️ Architecture ### Frontend (React 18) - Modern React with hooks and context - Tailwind CSS with custom design system - PWA capabilities with service worker - Responsive mobile-first design ### Backend (FastAPI) - Python FastAPI with async/await - Google Cloud Text-to-Speech integration - MongoDB with Motor async driver - RESTful API with comprehensive endpoints ### Database (MongoDB) - User progress tracking - Vocabulary management with cultural metadata - Audio caching for performance - Quiz session storage ## 🚀 Quick Start ### Prerequisites - Docker and Docker Compose - Domain name (for production) - Google Cloud Text-to …