Emmanuel-cpp/Zambia-Quiz-Mobile-App

# 🇿🇲 Zambia Quiz - Android App An interactive educational quiz application about Zambia, featuring **1,294+ questions** loaded dynamically from a cloud API, with **509 offline questions** as a fallback. Built with modern Android architecture using Kotlin Coroutines, Retrofit, and the Singleton pattern. --- ## ✨ Features ### **Core Quiz Features** - ✅ **1,294+ Questions** - Dynamically loaded from cloud API - ✅ **509 Offline Questions** - Local fallback for offline use - ✅ **8+ Categories** - Geography, History, Sports, Culture, Economics, Politics, General Knowledge, and more - ✅ **3 Difficulty Levels** - Easy, Medium, Hard - ✅ **Timed Quizzes** - 20-second timer per question with visual countdown - ✅ **Multiple Quiz Lengths** - Choose 10 or 20 questions per session - ✅ **Smart Question Selection** - Random and category-based filtering ### **Network & Data** - ✅ **REST API Integration** - Connects to `sangwapo.com` - ✅ **Hybrid Architecture** - Server-first with local fallback - ✅ **Offline Mode** - Works without internet using local storage - ✅ **Smart JSON Parsing** - Handles inconsistent data formats gracefully - ✅ **Singleton Pattern** - Questions loaded once, shared across screens ### **User Experience** - ✅ **Sound Effects** - Audio feedback for correct/wrong answers - ✅ **Haptic Feedback** - Vibration on answer selection - ✅ **Beautiful UI** - Zambian-themed design with flag colors - ✅ **Background Slideshow** - Scenic Zambian imagery with smooth transitions - ✅ **Smooth Animations** - Page transitions, button bounces, fade effects - ✅ **Splash Screen** - Branded loading experience while fetching questions - ✅ **Progress Indicators** - Visual progress bar and question counter - ✅ **Result Sharing** - Share scores via any messaging app - ✅ **Performance Stats** - Correct, wrong, skipped questions and time taken --- ## 🛠️ Technologies Used ### **Core Stack** - **Language:** Kotlin - **Min SDK:** 24 (Android 7.0) - **Targ …