Project Name: Aeribli Shukran - Kheir

Project Name: Aeribli Shukran - Kheir Zad Arabic Language Competitions (تطبيق اعرب لي شكراً - خير زاد)

Tagline: A gamified educational quiz application tailored for Arabic grammar, orthography, and language arts, powered by dynamic local spreadsheet ingestion and interactive lifelines.

Overview: Aeribli Shukran (خير زاد لمسابقات اللغة العربية) is an educational trivia and learning application built to make mastering Arabic grammar (Nahw), spelling rules (Imlaa), and rhetoric engaging for primary, preparatory, and secondary students. Designed around curriculum-aligned competitions, the app parses structured exam banks directly from bundled Excel spreadsheets on the device, allowing students to filter challenges by educational stage, grade level, semester, and topic with interactive audio cues and lifelines.

Role: Flutter Developer (Engineered the competition state machine, on-device spreadsheet question ingestion, interactive quiz UI, audio system, and AdMob integration).

Tech Stack:

Framework & UI: Flutter & Dart (Custom Arabic typography with Amiri & Marhey fonts, SVG vector graphics)

State Management: Flutter BLoC & Cubit (cubit-based architecture for game flow, quiz setup, sounds, and PDFs)

Offline Data Engine: Excel package (Dynamic runtime spreadsheet parsing of question banks and metadata)

Media & Audio: AudioPlayers (interactive sound effects, lifelines, and audio feedback)

Document Viewing: Syncfusion Flutter PDF Viewer (embedded educational guides and curriculum notes)

Monetization & Storage: Google Mobile Ads (AdMob banner & interstitial ads), shared_preferences

Key Features:

Multi-Stage Academic Filtering: Allows students to customize quiz sessions by academic stage (Primary, Preparatory, Secondary), grade level, semester, and specific grammar/spelling topics.

On-Device Excel Question Ingestion: Reads and structures extensive question datasets dynamically from Excel spreadsheets without requiring a persistent remote database.

Interactive Gamified Quiz Arena: Timed question flow with multiple-choice options, instant visual and audio feedback, question navigation, and 50/50 lifeline option elimination.

Dedicated Spelling (Imlaa) Module: Age-targeted spelling challenges designed specifically to strengthen written literacy and orthographic rules.

Comprehensive Performance Scoring: Displays detailed end-of-game evaluations tracking correct vs. incorrect answers, percentages, and learning recommendations.

Integrated Study Guides & PDF Viewer: In-app curriculum review sheets, author credentials, and educational notes viewable directly via an integrated PDF reader.

AdMob Monetization: Integrated rewarded and interstitial advertising workflows configured to maintain an uninterrupted student learning experience.