Emmanuel-Elikem/asaase-yaa

Asaase Yaa — Ghana climate engagement Flutter prototype (video feed, quiz, Climate Points, citizen report, emergency) # Asaase Yaa **Mother Earth, in your pocket.** Climate video learning → quizzes → Climate Points → citizen reporting & emergency help. > **GitHub:** github.com > Hackathon prototype for **University of Ghana / Africa Climate Collaborative**. > Full product vision includes a voice-first agentic assistant (**Kasa** — separate repo, not merged yet). ## Branch strategy - `main` — stable demo-ready baseline - `feat/ ` / `fix/ ` — short-lived feature work (PR into `main`) - Optional `develop` later if the team wants an integration branch — not required for prototype - **No GitHub Actions CI** — verify locally before merge ## One-liner Asaase Yaa is an AI-powered climate platform that combines personalised climate video learning, quizzes, Climate Points, citizen environmental reporting and emergency assistance — turning everyday phone use into meaningful climate engagement. ## Demo loop ``` Open → Onboarding (short) → Climate video feed → Watch/Swipe → Quiz → Climate Points → Report / Emergency ``` ## Quick start ```bash cd /home/demigod/PROJECTS/asaase-yaa flutter pub get flutter run # device / emulator flutter run -d chrome # web demo ``` ## How to verify (Built ≠ Done — local only) **Done = built + locally verified.** See `.github/agents/AsaaseYaa-Testing-Guide.md`. **No GitHub Actions CI** (free account limits). Do not rely on workflow checks. Run everything on your machine: ```bash flutter analyze flutter test flutter run -d chrome # then walk design QA checklist in Testing Guide ``` Never claim a screen or feature Done without these passing locally and Progress Tracker **Verified** filled. ### Optional live YouTube search 1. Enable **YouTube Data API v3** and create an API key (see `.github/agents/AsaaseYaa-YouTube-Integration.md`). 2. Run with: ```bash flutter run --dart-define=YOUTUBE_API_KEY=YOUR_KEY ``` Without a key, the app uses a **curated fallback video list** (playback via IFrame — no key ne …