PawFriend

PawFriend is a multi-language gamified learning app where you adopt a magical companion animal (fox, puppy) that grows and learns with you.

🎯 Available in 5 languages: English 🇬🇧, French 🇫🇷, Spanish 🇪🇸, German 🇩🇪, Arabic 🇸🇦 (with RTL support)

When you study, focus, and answer quizzes correctly, your companion gains XP, levels up (baby → adolescent → adult), and sends you encouraging messages. The goal is to be consistent xith your learning so your companion can stay nourished and hydrated.

✨ Features

🌍 Multi-Language Support

5 languages: English 🇬🇧, French 🇫🇷, Spanish 🇪🇸, German 🇩🇪, Arabic 🇸🇦
Language selector: Top-right dropdown with flag icons
RTL support: Arabic automatically switches to right-to-left layout
Real-time switching: Instant language changes across entire app
Persistent choice: Language selection saved in localStorage
Complete translation: Every button, message, and feature translated
Context-aware content: Animal messages adapt to selected language

🎓 Smart Study Sessions

Pomodoro Technique: 25-minute focus sessions + 5-minute breaks
AI-Powered Study Plans: Upload documents (PDF/DOCX) and get personalized study schedules according to the uploaded material
Cycle-by-Cycle Execution: Automated progression through multiple Pomodoro cycles
Detailed Guidance: Each cycle includes:
- Focus task description
- Specific objectives
- Key points to remember
- Progress tracking with checkboxes
Break Management: Automatic transitions between focus and rest periods
XP Rewards: +25 XP per completed 25-minute session

🧠 AI-Powered Quizzes

Topic-Based Generation: AI creates quizzes on any subject using Mistral AI
Multiple Choice: 3 questions per quiz, 4 options each
Instant Feedback: See if answers are correct immediately
XP Rewards: +20 XP per correct answer (60 XP max per quiz)

⚠️ Important Note: AI Content Limitations AI-generated quiz content may have inaccuracies or errors. The open-source model (Mistral AI) can sometimes:

Provide false answers or incorrect information
Omit correct answer options from the choices
Incorrectly evaluate answers as right or wrong
Generate misleading or inaccurate explanations
Wolfram Integration: Get detailed mathematical explanations for quiz questions
Themed Quizzes: Pre-made AI-generated quiz themes across subjects:
- Mathematics (Algebra, Geometry, Calculus)
- Sciences (Biology, Chemistry, Physics)
- History (Ancient civilizations, Medieval period, Modern era)
- Geography (Maps, Capitals, Demographics)
- Languages (Vocabulary, Grammar, Conjugation)
- Computer Science (Wolfram Language tutorials)

🐾 Companion System

Choose Your Companion: Fox or puppy, each with unique personality
Customizable Appearance: 4 aura colors (Galaxy Blue, Magic Purple, Energy Orange, Focus Green)
Level Progression:
- Baby (0-999 XP): Small, learning together
- Adolescent (1000-1999 XP): Growing stronger
- Adult (2000+ XP): Fully evolved companion
Context-Aware Messages: Dynamic messages based on activity:
- Dashboard: Motivational messages
- Study sessions: Focus encouragement
- Breaks: Health reminders (stretch, hydrate)
- Quizzes: Calm, supportive messages
Visual Evolution: Companion orb size and glow intensity increase with level

💧 Hydration Streaks

Water-Themed Motivation: 💧 symbols
Streak Tracking: Study daily to keep your companion hydrated
Personal Records: Track your max streak achievement
Dynamic Messages:
- 1 day: "Your companion is refreshed!"
- 3-6 days: "Keep your companion hydrated!"
- 7+ days: "Your companion stays hydrated! 💧"
- 14+ days: "Epic hydration!"
- 30+ days: "Legendary caregiver!"

📊 Learning Analytics

Study Sessions Counter: Total Pomodoro cycles completed (🎓)
Average Quiz Score: Calculated from XP earned (🎯)
Total Study Time: Minutes spent in focus sessions (⏱️)
Weekly Progress Chart: Visual bar chart of daily activity
Performance Indicators:
- Excellent (85%+): Green
- Good (70-84%): Yellow
- Keep Practicing (55-69%): Orange
- Needs Improvement (<55%): Red
Personalized Recommendations: Tips based on your performance

🔐 Authentication & Profiles

Supabase Integration: Real user accounts with email/password
Instant Signup: No email verification required for quick demos
Profile Persistence: All data saved to database:
- User name and companion details
- XP and level
- Streaks (current and max)
- Study time and completed cycles
- Last study date
Session Management: Automatic login restoration

📚 Document Processing

File Upload: Support for PDF, DOCX, and images
AI Ingestion: Documents automatically chunked and processed
Vector Storage: Content stored for intelligent retrieval
Study Plan Generation: AI uses uploaded materials to create customized plans

🍖 Companion Care & Feeding

Food Shop: Buy food for your companion using earned XP
Animal-Specific Food: Each companion type has unique foods:
- Puppy: Croquette (regular) and Muffin (special treat)
- Fox: Dango (regular) and Bao (special treat)
XP Economy:
- Regular food: Costs 5 XP, gives back 2 XP
- Special food: Costs 10 XP, gives back 5 XP (unlocked at adolescent level)
Feeding System: Interactive feeding with visual bowl states (empty/full)
Level Requirements: Special treats unlock when companion reaches adolescent level
Reward Mechanism: Feed your companion to receive bonus XP