KidsQuest 🎮

AI-Powered Learning Adventures for Elementary School Kids

Transform homework into epic gaming adventures! KidsQuest makes learning fun by converting educational assignments into engaging games that kids actually want to play.

🌟 Features

For Kids:

• 🎮 Fun Educational Games - Play games like Fraction Jump (platformer) and more
• 🏆 Earn Rewards - Unlock avatars, badges, themes, and power-ups with points
• 📊 Track Progress - See your streak, points, and achievements
• 🎨 Personalize - Customize your profile with unlocked rewards

For Parents:

• 📈 Real-Time Analytics - Track your child's learning progress with beautiful charts
• 🎯 Standards Alignment - See which learning standards your child is mastering
• 📝 Homework Assignments - Input weekly homework (coming soon)
• 🎁 Manage Rewards - View and approve rewards

🚀 Quick Start (5 Minutes)

Prerequisites:

• Node.js 20+
• Supabase account (free tier works!)

Setup:

1. Clone the repo

   git clone https://github.com/veebeeyoukay/eduquest.git
   cd eduquest
   npm install

2. Set up Supabase

   • Create a project at supabase.com
   • Copy your project URL and anon key
   • Create .env.local:

     NEXT_PUBLIC_SUPABASE_URL=your-project-url
     NEXT_PUBLIC_SUPABASE_ANON_KEY=your-anon-key
     NEXT_PUBLIC_APP_URL=http://localhost:3001

3. Run Database Migrations

   • Open Supabase SQL Editor
   • Run supabase/schema.sql
   • Run supabase/seed.sql
   • Run supabase/rewards.sql

4. Start the app

   npm run dev

   Visit http://localhost:3001

See QUICK_START.md for detailed instructions.

🎯 Tech Stack

• Frontend: Next.js 15 (App Router), React 19, TypeScript
• Styling: Tailwind CSS 4
• Database: PostgreSQL (Supabase)
• Authentication: Supabase Auth
• Game Engine: Phaser.js 3.86
• Charts: Recharts
• Deployment: Netlify (recommended)

📂 Project Structure

kidsquest-app/
├── app/                      # Next.js app directory
│   ├── page.tsx             # Landing page
│   ├── login/               # Parent authentication
│   ├── signup/              # Parent signup
│   ├── child-login/         # Child PIN login
│   ├── dashboard/           # Parent dashboard
│   └── child/[id]/          # Child views
│       ├── dashboard/       # Child dashboard
│       ├── games/           # Game pages
│       └── rewards/         # Rewards shop
├── components/
│   ├── ui/                  # Reusable UI components
│   ├── dashboard/           # Dashboard components
│   └── rewards/             # Reward system components
├── lib/
│   ├── supabase/            # Supabase client & server
│   └── phaser/              # Phaser game scenes
└── supabase/                # Database migrations

🎮 Games

Currently Playable:

• Fraction Jump - Platformer game teaching fractions (Grades 3-4)

Coming Soon:

• Math Race - Racing game for arithmetic
• Reading Adventure - Story-based comprehension
• Geometry Builder - Shape and measurement game
• Vocabulary Quest - Word learning adventure

🏪 Rewards System

Kids earn points by playing games and can unlock:

• Avatars (8 items) - Space Explorer, Super Hero, Dinosaur, and more
• Badges (6 items) - Achievement badges for milestones
• Themes (5 items) - Ocean, Space, Forest, Rainbow, Night Mode
• Accessories (5 items) - Sunglasses, Crown, Cape, and more
• Power-Ups (3 items) - Double Points, Time Freeze, Hint Helper

See REWARDS_SETUP.md for setup instructions.

📊 Parent Dashboard

Track your child's progress with:

• 4 Interactive Charts: Points, accuracy, games played, game type distribution
• Activity Timeline: Recent actions and achievements
• Learning Standards: Mastery progress on educational standards
• Game Sessions: Detailed performance data

🔒 Security & Privacy

• Row Level Security (RLS) policies for all data
• Parent authentication required for all admin functions
• Child PIN system for safe, parent-controlled access
• No personal data collection from children
• COPPA compliant architecture

🌐 Deployment

Deploy to Netlify:

1. Push your code to GitHub
2. Connect to Netlify
3. Set environment variables:

   NEXT_PUBLIC_SUPABASE_URL=your-url
   NEXT_PUBLIC_SUPABASE_ANON_KEY=your-key
   NEXT_PUBLIC_APP_URL=https://your-app.netlify.app
   

4. Deploy!

Build command: npm run build Publish directory: .next

📝 License

MIT License - See LICENSE for details

🤝 Contributing

Contributions welcome! Please read our contributing guidelines first.

💬 Support

• 📧 Email: support@kidsquest.ai
• 🐛 Issues: GitHub Issues
• 📖 Docs: See /docs folder for detailed documentation

🎓 Built With Love

Created to make learning fun for elementary school kids. Powered by AI and built with modern web technologies.

---

KidsQuest - Where Learning Meets Adventure! 🚀