manyaug/manya-ug

# 🚀 Manya Prep Hub (v2.0.1) Welcome to the **Manya Prep Hub** master documentation. This repository contains a state-of-the-art interactive education platform designed for students in **Uganda** preparing for their **Primary Leaving Examinations (PLE)**. Manya is more than just a quiz app; it is an **Adaptive Interactive Orchestrator** that combines character-driven storytelling with deep pedagogical engines in Math, English, Science, and Social Studies. --- ## 🏗️ High-Level Architecture Manya uses a decoupled "Engine" architecture where the UI shell is independent of the curriculum logic. ```mermaid graph TD subgraph "Content Authoring" Excel["Microsoft Excel (CMS)"] --> SyncScript["sync-excel-db.cjs"] SyncScript --> SupabaseDB[("Supabase (PostgreSQL)")] GitHub["GitHub Repo"] --> CDN["jsDelivr CDN (v2.0.1)"] end subgraph "The Application" App[React/Vite Shell] --> Loader["QuestLoader (JSON)"] Loader --> Dispatcher["QuestRunner (Dispatcher)"] Dispatcher --> EngineRegistry{"Engine Registry"} end subgraph "Interactive Engines" EngineRegistry --> MathEng["Math: Venn, Binary, Pizza"] EngineRegistry --> SciEng["Science: 3D Models, Hotspots"] EngineRegistry --> EngEng["English: Grammar, Chat, Story"] EngineRegistry --> SstEng["SST: Globe, Maps, Notes"] end SupabaseDB SyncService["SyncService (Real-time Answers)"] SyncService App CDN --> App ``` --- ## 🛠️ Technical Stack | Category | Technology | Purpose | | :--- | :--- | :--- | | **Core** | React 19, Vite 6 | Library and Build Tooling | | **State** | Redux Toolkit (RTK) | Global User, Audio, and UI State | | **Database** | Supabase | Master Quest Data, Answer Logs, Achievements | | **Animation** | Framer Motion | Fluid transitions and mascot animations | | **Styling** | Tailwind CSS / CSS Modules | Premium "Adventure" Design System | | **Visualization** | D3.js, Topojson | Mathematical diagrams and Geographic maps | | **Offline** | Vite PWA / Workbox | Full curriculum caching and offline resilience | | **D …