FrankBahle/afriquest

AfriQuest is an AI-powered challenge game that helps users explore real African problems and discover practical technology solutions that can improve communities. # GRIT Lab Africa AI for SDGs Card Game A web-based educational card game where players solve African development challenges using AI solution cards. Players select problem cards, choose one to three AI cards, explain their solution, receive AI-generated scoring feedback, earn GLA Coins, and work toward unlocking a certificate. This project is currently focused on the **front-end user interface only**. Backend services, real admin authentication, database storage, multiplayer sockets, and file upload APIs are not included yet. --- ## Project Overview The game teaches players how artificial intelligence can be applied to real-world African challenges aligned with the Sustainable Development Goals. The player journey includes: 1. Reading the game guide. 2. Selecting at least 10 problem cards. 3. Starting a game round. 4. Viewing a random problem card. 5. Choosing up to 3 AI solution cards. 6. Writing a short explanation of the selected AI solution. 7. Submitting the solution for AI scoring. 8. Earning GLA Coins based on the score. 9. Viewing feedback, retrying, and progressing toward a certificate. The admin journey includes a separate static admin login and admin dashboard interface for managing game content and reviewing analytics. --- ## Main Features ### Player Features - Public landing page - Player login and registration UI - Game guide screen - Problem card selection screen - Play game screen - AI card selection - Selected AI solution board - Explanation box with 100-word limit - AI scoring integration through the existing service file - Score and feedback screen - Detailed sub-score breakdown - Retry attempt screen - First score, latest score, and best score views - GLA Coin balance - GLA Coin earned display - GLA Coin spent on hints display - GLA Coin transaction history - Hint request confirmation - Hint history screen - Advanced hint levels screen - Player dashboard - Player profile screen - Best-scoring problem cards section - Completed problem …