fadelfffar/swahili_lingo

# 🌍 Swahili Lingo A Flutter quiz app for learning **everyday Swahili** — greetings, shopping, food, transport, family life, and health vocabulary. **👉 Try it live** --> ## ✨ Features - 📝 **Interactive Quiz** — Multiple-choice questions on essential everyday Swahili vocabulary - 🌍 **Real-life Content** — Greetings, market bargaining, food ordering, transport, family, and health - 🔊 **Audio Pronunciation** — Text-to-speech for Swahili phrases (sw-KE / sw-TZ locale) - 🔄 **Bilingual Toggle** — Switch between Swahili and English translations - 📊 **Progress Tracking** — Visual progress bar, immediate answer feedback, and final score ## 📚 Topics Covered | Mada (Topic) | Mifano (Examples) | |---|---| | Salamu & Utambulisho (Greetings & Introductions) | `Habari yako?`, `Jina langu ni...`, `Shikamoo / Marahaba`, `Karibu / Asante` | | Soko & Ununuzi (Shopping & Market) | `Bei gani?`, `Punguza bei`, namba & `shilingi` | | Chakula & Mgahawa (Food & Eating Out) | `Naomba chai`, `Chakula kiko tayari?`, ugali, chapati, pilau | | Usafiri & Mwelekeo (Transport & Directions) | daladala / matatu, `Kituo cha basi kiko wapi?`, `kushoto / kulia / moja kwa moja` | | Familia & Maisha ya Kila Siku (Family & Daily Routine) | familia, mama/baba/ndugu, `Ninaamka asubuhi`, siku za juma | | Afya & Dharura (Health & Emergencies) | `Ninaumwa`, `Nahitaji daktari`, `Msaada!`, `duka la dawa` | ## 🚀 Getting Started ### Prerequisites - Flutter SDK 3.x or later - A device, emulator, or Chrome (for web) ### Setup ```bash git clone github.com cd swahili_lingo flutter pub get flutter run ``` ### Run Tests ```bash flutter test ``` ### Run Web ```bash flutter run -d chrome ``` ## 🌍 Deployment The web app auto-deploys to GitHub Pages on every push to `main`. > One-time setup: enable **Settings → Pages → Source: GitHub Actions**. ## 🧩 Tech Stack | Package | Purpose | |---|---| | `flutter_tts` | Swahili audio pronunciation (sw-KE / sw-TZ) | | `flutte …