Skip to content

Emma-Aima/App-Vibe-Coding2.0

Repository files navigation

Assignment Handler - Homework Helper App

A comprehensive mobile application designed to help busy parents support their children's homework through AI-powered explanations, photo scanning, and multilingual support.

Project Lead:

Ileogben Emmanuella Aimalohi - emmanuellaileogben@gmail.com

Title of the Project: Homework Helper for Busy Parents

Problem: Parents struggle to help their children with homework, especially for unfamiliar topics. Challenge: Build an AI chatbot where parents can input a photo or question, and get a simple, friendly explanation or walkthrough. πŸ’° Monetization: - Pay-per-use (KES 5–10 per question) - Monthly family subscription - Partner with schools or edtechs

MGX: Link for the story board of a promotional video on all social media platforms for the Assignment Handler Application

https://mgx-5qnn5wfhcem.mgx.world

πŸ“± App Overview

Assignment Handler is a production-ready homework assistance app that bridges the gap between busy parents and their children's educational needs. The app provides instant, child-friendly explanations for homework questions through both photo capture and text input, supporting multiple languages and offering flexible payment options.

✨ Key Features

Core Functionality

  • Photo Scanning: Capture homework questions using the device camera with OCR processing
  • Text Input: Type questions directly for instant AI-powered explanations
  • Multilingual Support: Available in English, Swahili, and French with easy language switching
  • Subject Categorization: Organized support for Mathematics, Science, English, and General subjects
  • Child-Friendly Explanations: Simple, age-appropriate explanations that parents can easily understand and relay

User Experience

  • Learning History: Complete tracking of all questions asked with search and filter capabilities
  • Progress Analytics: Visual statistics showing questions asked, average ratings, and learning streaks
  • Family Management: Support for multiple children profiles with individual tracking
  • Feedback System: Rate explanations and request follow-up clarifications

Monetization

  • Pay-Per-Question: KES 10 per individual question for occasional users
  • Student Plan: KES 200/month for unlimited questions and premium features
  • Family Plan: KES 500/month supporting up to 5 children with advanced analytics
  • Payment Integration: Ready for M-Pesa and card payment processing

πŸ—οΈ Technical Architecture

Platform & Framework

  • Expo SDK: 52.0.30 with Expo Router 4.0.17
  • React Native: Cross-platform mobile development
  • TypeScript: Full type safety throughout the application
  • Target Platforms: iOS, Android, and Web (with platform-specific optimizations)

Navigation Structure

app/
β”œβ”€β”€ _layout.tsx                 # Root layout with Stack navigator
β”œβ”€β”€ (tabs)/                     # Tab-based navigation
β”‚   β”œβ”€β”€ _layout.tsx            # Tab bar configuration
β”‚   β”œβ”€β”€ index.tsx              # Home screen
β”‚   β”œβ”€β”€ camera.tsx             # Photo scanning interface
β”‚   β”œβ”€β”€ history.tsx            # Learning history and analytics
β”‚   β”œβ”€β”€ payment.tsx            # Subscription and payment management
β”‚   └── profile.tsx            # User profile and settings
β”œβ”€β”€ +not-found.tsx             # 404 error handling
└── components/
    └── ExplanationScreen.tsx   # AI explanation display component

Key Dependencies

  • expo-camera: Camera integration with permission handling
  • expo-router: File-based routing system
  • lucide-react-native: Consistent icon system
  • @expo-google-fonts/inter: Typography with Inter font family
  • react-native-safe-area-context: Safe area handling across devices

🎨 Design System

Color Palette

  • Primary Blue: #2563EB - Main brand color for buttons and highlights
  • Success Green: #10B981 - Positive feedback and success states
  • Warning Orange: #F59E0B - Attention and premium features
  • Error Red: #EF4444 - Error states and destructive actions
  • Neutral Grays: #F8FAFC to #1F2937 - Text and background variations

Typography

  • Font Family: Inter (Regular, Medium, SemiBold, Bold)
  • Hierarchy:
    • Headlines: 28px Inter-Bold
    • Titles: 20px Inter-SemiBold
    • Body: 16px Inter-Regular
    • Captions: 12px Inter-Regular

Spacing System

  • Base Unit: 8px grid system
  • Component Padding: 16px, 20px, 24px
  • Element Margins: 8px, 12px, 16px, 24px, 32px

πŸ“‹ User Personas

1. Sarah - The Non-Tech-Savvy Parent

  • Age: 42, works part-time
  • Challenge: Struggles with complex apps and modern homework topics
  • Needs: Simple interface, clear instructions, reliable explanations
  • App Benefits: Intuitive camera scanning, step-by-step guidance, multilingual support

2. Michael - The Full-Time Working Parent

  • Age: 38, corporate executive
  • Challenge: Limited time for homework help, travels frequently
  • Needs: Quick solutions, mobile accessibility, progress tracking
  • App Benefits: Instant explanations, history tracking, family plan for multiple children

3. Amina - The Multi-Child Parent

  • Age: 35, manages 3 children's education
  • Challenge: Different grade levels, various subjects, budget constraints
  • Needs: Cost-effective solution, child-specific tracking, comprehensive support
  • App Benefits: Family plan pricing, individual child profiles, subject categorization

πŸ”„ User Flow

Primary Flow: Photo Question

  1. Home Screen: Parent selects "Take Photo" option
  2. Camera Screen: Capture homework question with guided interface
  3. Review: Confirm image quality and subject selection
  4. Processing: AI analyzes image and generates explanation
  5. Explanation: Display child-friendly answer with detailed breakdown
  6. Feedback: Rate explanation and request follow-up if needed
  7. History: Save to learning history for future reference

Secondary Flow: Text Question

  1. Home Screen: Parent types question in text input
  2. Subject Selection: Choose appropriate subject category
  3. Language: Confirm explanation language preference
  4. AI Processing: Generate contextual explanation
  5. Explanation Display: Show formatted answer with examples
  6. Follow-up Options: Request clarification or ask related questions

πŸ’° Monetization Strategy

Pricing Tiers

  • Pay-Per-Use: KES 10 per question

    • Perfect for occasional help
    • No commitment required
    • Instant access to explanations
  • Student Plan: KES 200/month

    • Unlimited questions
    • Priority AI responses
    • Complete learning history
    • Offline access to previous answers
  • Family Plan: KES 500/month

    • Up to 5 children profiles
    • Parent progress dashboard
    • Weekly learning reports
    • Priority customer support

Payment Integration

  • M-Pesa: Primary payment method for Kenyan market
  • Card Payments: Visa, Mastercard support for broader accessibility
  • Subscription Management: Easy cancellation and plan changes
  • Security: Encrypted payment processing with PCI compliance

πŸ›‘οΈ Safety & Content Moderation

Question Appropriateness

  • AI Content Filter: Automatic screening for inappropriate content
  • Safe Learning Environment: Age-appropriate explanations only
  • Fallback Responses: Polite redirection for unclear or inappropriate questions
  • Parent Controls: Content filtering and usage monitoring

Privacy Protection

  • Data Encryption: All user data encrypted in transit and at rest
  • Minimal Data Collection: Only necessary information for service delivery
  • COPPA Compliance: Child privacy protection standards
  • Parental Consent: Clear consent mechanisms for child data

🌍 Multilingual Support

Supported Languages

  • English: Primary language with full feature support
  • Swahili: Complete translation for East African market
  • French: Full localization for Francophone regions

Implementation

  • Dynamic Language Switching: Real-time language changes without app restart
  • Contextual Translation: Subject-specific terminology in each language
  • Cultural Adaptation: Locally relevant examples and explanations

πŸ“Š Analytics & Tracking

User Metrics

  • Question Volume: Track daily/weekly question patterns
  • Subject Distribution: Popular subjects and difficulty levels
  • User Engagement: Session duration and feature usage
  • Satisfaction Scores: Explanation ratings and feedback analysis

Business Intelligence

  • Conversion Tracking: Free to paid user progression
  • Churn Analysis: Subscription retention and cancellation reasons
  • Feature Adoption: Most and least used app features
  • Performance Monitoring: App speed and reliability metrics

πŸš€ Development Setup

Prerequisites

  • Node.js 18+ and npm/yarn
  • Expo CLI installed globally
  • iOS Simulator (Mac) or Android Emulator
  • Expo Go app for device testing

Installation

# Clone the repository
git clone [repository-url]
cd assignment-handler

# Install dependencies
npm install

# Start development server
npm run dev

Environment Configuration

Create .env file with required variables:

EXPO_PUBLIC_API_URL=https://api.assignmenthandler.com
EXPO_PUBLIC_OPENAI_API_KEY=your_openai_key
EXPO_PUBLIC_MPESA_API_KEY=your_mpesa_key

Platform-Specific Development

// Example of platform-specific code
import { Platform } from 'react-native';

const triggerFeedback = () => {
  if (Platform.OS !== 'web') {
    // Native haptic feedback
    Haptics.impactAsync();
  } else {
    // Web alternative - visual feedback
    setButtonPressed(true);
  }
};

πŸ§ͺ Testing Strategy

Unit Testing

  • Component rendering and props validation
  • Utility function correctness
  • State management logic verification

Integration Testing

  • Camera functionality across devices
  • Payment flow validation
  • API integration testing

User Acceptance Testing

  • Parent usability sessions
  • Child explanation comprehension tests
  • Cross-platform compatibility verification

πŸ“ˆ Future Roadmap

Phase 2 Features

  • Voice Input: Speak questions instead of typing
  • Handwriting Recognition: Better OCR for handwritten text
  • Video Explanations: Visual learning for complex concepts
  • Teacher Collaboration: Direct communication with child's teachers

Phase 3 Enhancements

  • Offline Mode: Basic functionality without internet
  • Gamification: Learning streaks and achievement badges
  • Peer Learning: Connect with other parents for support
  • Advanced Analytics: Detailed learning progress reports

Market Expansion

  • Additional Languages: Spanish, Portuguese, Arabic support
  • Regional Pricing: Localized pricing for different markets
  • School Partnerships: Institutional licensing and integration
  • Curriculum Alignment: Standards-based question categorization

🀝 Partnership Opportunities

School Integration

  • Teacher Dashboard: Monitor student homework assistance usage
  • Curriculum Alignment: Match explanations to school standards
  • Progress Reports: Share learning analytics with educators
  • Bulk Licensing: Discounted rates for school-wide adoption

Educational Publishers

  • Content Integration: Textbook-specific explanations
  • Supplementary Materials: Additional practice problems
  • Assessment Tools: Quiz generation from homework topics

πŸ“ž Support & Contact

User Support

  • In-App Help: Comprehensive FAQ and tutorials
  • Email Support: help@assignmenthandler.com
  • WhatsApp Support: +254-XXX-XXXX (Kenya)
  • Video Tutorials: YouTube channel with usage guides

Technical Support

  • Developer Documentation: API and integration guides
  • GitHub Issues: Bug reports and feature requests
  • Community Forum: User and developer discussions

πŸ“„ Legal & Compliance

Terms of Service

  • Clear usage guidelines and limitations
  • Subscription terms and cancellation policies
  • Content ownership and intellectual property rights

Privacy Policy

  • Data collection and usage transparency
  • Child privacy protection measures
  • Third-party service integration disclosures

Accessibility

  • WCAG 2.1 AA compliance for web platform
  • Screen reader compatibility
  • High contrast mode support
  • Large text options for visually impaired users

Assignment Handler - Empowering parents to support their children's education, one question at a time.

Built with ❀️ for busy parents everywhere