# 🎓 User Guide
Learn how to use LearnAI TV like a pro! This guide is for students, parents, and teachers.
🚀 Getting Started
Step 1: Access the Platform
Visit: https://iavendas62-collab.github.io/learnai-tv/
Requirements:
✅ Modern browser (Chrome, Firefox, Safari, Edge)
✅ Internet connection
✅ No account needed!
Step 2: Choose Your Subject
You'll see 6 subjects on the left sidebar:
📐 Matemática
🧮
Numbers, operations, geometry, fractions
📝 Português
📖
Grammar, reading, writing, vocabulary
🔬 Ciências
🌱
Nature, human body, experiments, ecology
🏰 História
📜
Brazilian history, Fortaleza culture, heritage
🌍 Geografia
🗺️
Maps, climate, environment, regions
💬 Idiomas
🌎
English vocabulary, basic conversation
Navigation:
Mouse: Click on any subject
Keyboard: Use arrow keys (↑↓) + Enter
Step 3: Pick an Activity
After choosing a subject, you'll see 4 activity cards:
📖 Activity 1: Study Topics
What it does: Learn new concepts with AI-generated explanations.
How to Use:
Click "📖 Estudar Tópicos"
Wait 3-5 seconds while AI generates topic list
Choose a topic from the grid (8 options)
Read the explanation with visual examples
(Optional) Use the drawing canvas if available
Pro Tips:
✅ Read slowly - AI explanations are detailed ✅ Look for shapes - Geometry shows interactive visuals ✅ Take notes - Write down key points ✅ Try exercises - AI often suggests practice problems
Example Flow:
💬 Activity 2: Chat with AI
What it does: Ask homework questions and get instant answers.
How to Use:
Click "💬 Conversar com IA"
Type your question in the input box
Press Enter or click "Enviar"
Wait 3-8 seconds for AI response
Continue the conversation!
What You Can Ask:
Concept explanation
"O que é fotossíntese?"
Detailed explanation with examples
Math problems
"Como resolver 2x + 5 = 15?"
Step-by-step solution
Homework help
"Me ajuda com verbos no passado"
Rules + examples + practice
Curiosities
"Por que o céu é azul?"
Fun scientific facts
Chat Features:
🧠 Memory - AI remembers your conversation
🔗 Wolfram links - Math answers include full solutions
📊 LaTeX formulas - Equations render beautifully
💬 Natural language - Talk like you're texting a friend
Pro Tips:
✅ Be specific - "Explain fractions" → "Explain 1/2 + 1/4" ✅ Ask follow-ups - "Can you give another example?" ✅ Use context - AI remembers what you talked about ✅ Try different subjects - Switch topics anytime
Limitations:
❌ Don't ask for full homework answers - AI encourages learning, not cheating ❌ Stay on school topics - Off-topic questions won't work well ❌ One question at a time - Wait for response before asking next
🎯 Activity 3: Take a Quiz
What it does: Test your knowledge with 5 AI-generated questions.
How to Use:
Click "🎯 Fazer Quiz"
Wait 5-10 seconds while AI creates questions
Read question carefully
Click your answer (a, b, c, or d)
See instant feedback (green = correct, red = wrong)
Read the explanation
Click "Próximo →" to continue
After 5 questions, see your final score!
Scoring System:
✅ Correct answer
+10 points
+10 XP
❌ Wrong answer
0 points
0 XP
Total possible per quiz: 50 points
Quiz Features:
🎲 Random questions - Different every time
📚 Topic-based - Questions match what you studied
💡 Instant feedback - No waiting for grades
📖 Explanations - Learn why the answer is correct
Pro Tips:
✅ Read all options - Don't rush! ✅ Eliminate wrong answers - Use logic ✅ Learn from mistakes - Read explanations even when correct ✅ Retake quizzes - Practice makes perfect
🎲 Activity 4: Surprise Challenge
What it does: Get a random hard question for bonus points!
How to Use:
Click "🎲 Desafio Surpresa"
Wait for AI to create a challenging question
Answer carefully (only 1 chance!)
Earn 15 points if correct (vs 10 in regular quiz)
When to Use Challenges:
🔥 Warm up before studying
🎯 Test retention across subjects
💪 Push yourself outside comfort zone
🏆 Compete with friends for high scores
Pro Tips:
✅ Don't overthink - First instinct is often correct ✅ Use what you learned - Apply knowledge from topics ✅ Try again immediately - Each challenge is different
🏅 Gamification & Rewards
Point System
Every action earns rewards:
Study a topic
+5
+5
Correct quiz answer
+10
+10
Complete challenge
+15
+15
Chat interaction
+2
+2
Level Progression
Level-Up Animation
When you level up:
🚀 Golden explosion animation
🎉 "LEVEL UP!" message
📊 New level displayed in header
Track Your Progress
Look at the top-right corner:
👨👩👧👦 For Parents
How to Support Your Child:
Set a study routine
20-30 minutes daily
Same time each day
Quiet, distraction-free space
Monitor progress
Check their level/points
Ask what they learned today
Review quiz scores together
Encourage exploration
Let them choose subjects
Celebrate small wins
Don't pressure perfection
Use the chat together
Ask questions as a family
Model curiosity
Make learning social
Safety Notes:
✅ No personal data collected - Completely anonymous ✅ No ads or tracking - Safe for kids ✅ Age-appropriate content - Designed for 7-13 year olds ✅ No chat with strangers - Only talks to AI
👩🏫 For Teachers
Classroom Usage Ideas:
1. Homework Supplement
Assign specific topics to study
Students take quizzes at home
Review common mistakes in class
2. Interactive Review
Project on classroom screen
Students take turns answering
Discuss AI explanations together
3. Differentiated Learning
Fast learners: Challenge mode
Struggling students: Chat for 1-on-1 help
Everyone progresses at their pace
4. Gamified Competition
Weekly leaderboard (points)
Team challenges
Rewards for leveling up
Content Customization:
Teachers can request custom content by:
Creating a Google Doc with curriculum
Sharing doc ID with platform admin
Content appears in student's topics!
Contact: [your-email] for custom curriculum integration
⌨️ Keyboard Shortcuts
Arrow Keys
Navigate sidebar subjects
Enter
Select highlighted item
Escape
Return to activity hub
Backspace
Reload page (reset)
Tab
Move between elements
Accessibility: Fully keyboard-navigable for users who can't use a mouse!
🐛 Troubleshooting
Problem: "Loading..." stuck forever
Solution:
Check internet connection
Refresh page (F5 or Ctrl+R)
Try a different browser
Clear browser cache
Problem: Quiz shows "Tópico 1, Tópico 2" instead of real topics
Solution:
This is the fallback mode (AI didn't respond)
Topics are still clickable and work fine
Refresh and try again for AI-generated topics
Problem: Chat not responding
Solution:
Wait 10 seconds (AI is thinking)
Rephrase your question simpler
Check if you're still on the chat screen
Refresh and start new conversation
Problem: No sound/animations
Solution:
Animations are visual only (no sound by design)
Check if browser blocks animations
Update to latest browser version
Still Having Issues?
📧 Email: [your-support-email] 💬 Discord: [hackathon-support-channel] 🐙 GitHub Issues: https://github.com/iavendas62-collab/learnai-tv/issues
📱 Mobile Usage
LearnAI TV works great on phones and tablets!
Mobile Features:
✅ Touch-optimized buttons
✅ Responsive layout (adapts to screen size)
✅ Swipe-friendly navigation
✅ Drawing canvas supports touch
Best Experience:
Landscape mode for quizzes
Portrait mode for chat
WiFi connection recommended
🌟 Tips for Success
Study daily - Even 10 minutes helps!
Mix activities - Don't just do quizzes
Ask questions - Use the chat liberally
Review mistakes - Read all explanations
Challenge yourself - Try harder topics
Have fun! - Learning should be enjoyable
Remember: There's no "perfect" score. The goal is to learn and improve! 🎓✨
Last updated