StreetLight Study Buddy

This document is restricted. Please sign in to continue.

🎮 Game Prototypes
Select your class to view available games

StreetLight Study Buddy

End-to-End Product Flow — All 6 Phases

PHASE 1

App Launch

JWT check — route to onboarding or home
Splash Screen
App opens, branding shown, JWT check fires
JWT Check
Valid → Home | Invalid → Onboarding
Splash Screen
Duration~1–2s, non-blocking
What firesJWT validity check in background
JWT Check — ADR-009
Valid tokenSkip onboarding → Home Dashboard
Invalid / expired→ Onboarding Phase 2
New User Only ↓
PHASE 2

Onboarding

New users only — one-time setup
Phone OTP
Firebase Auth, Supabase session issued
Avatar Picker
Character + name + class / grade selection
Profile Saved
Supabase write → JWT issued → Home
Phone OTP
ProviderFirebase Auth
SessionSupabase session issued on success
Avatar Picker
FieldsCharacter, Display Name, Class / Grade
Profile Saved
ActionSupabase write → JWT issued → Redirect Home
All Sessions Land Here ↓
PHASE 3

Home Dashboard

Student home dashboard — simple and action-focused.
Ask AI Tutor
Instant help for doubts, concept walkthroughs, and homework support.
Join Live Class
See upcoming live sessions and join class with one tap.
Challenge Inbox
All student challenges in one place with accept / reject actions.
Ask AI Tutor
PurposeText or voice-based study help for students.
Use casesDoubt solving, homework tips, concept explanations.
Join Live Class
Session listUpcoming live lessons, join buttons, and countdowns.
AccessDirect entry to class room or streaming session.
Challenge Inbox
ContentAll incoming challenges for the student.
ActionsAccept or reject each challenge from this dashboard.
3 Learning Paths ↓
PHASE 4

Learning Paths

Study · Doubt · Challenge
Path A — Study
Chapter list → AI tutor chat
Path B — Doubt Upload
Photo or typed doubt → AI explanation
Path C — Challenge
Find classmate → pick mode → send challenge
Path A — Study
FlowSelect Chapter → AI Tutor Chat
Path B — Doubt Upload
InputPhoto or typed question
OutputAI-generated explanation
Path C — Challenge
StepsFind classmate → Pick mode → Send challenge
Path C → Battle ↓
PHASE 5

Quiz Battle

Real-time 1v1 — v5.0 Mode System
Battle Modes
Standard vs Rapid (v5.0)
Adaptive XP Matrix
Gold / Silver / Base tiers
Timer UX Zones
Color-coded zones per mode
Battle Modes — v5.0
Parameter Standard Rapid
Questions 8 10
Question Timer 90 seconds 30 seconds
Max Duration 12 minutes 5 minutes
Objective Deep Analysis Speed Recall
Adaptive XP Matrix (v5.0)
Mode Tier Time Window XP
Standard Gold 0–30s 2.50
Silver 31–60s 2.25
Base 61–90s 2.00
Rapid Gold 0–15s 2.50
Base 16–30s 2.00
Timer UX Zones
Standard (90s)🟢 0–30s → 🟡 31–60s → 🔴 61–80s → ⚡ 81–90s
Rapid (30s)🟢 0–15s → 🔴 16–25s → ⚡ 26–30s
Battle Ends ↓
PHASE 6

Battle End & Review

Results • Recovery • Olympiad
Review Mistakes
Recovery Quest +3 XP
Olympiad & Leaderboard
Weekend Event + Rewards
Review Mistakes — Recovery Quest (ADR-014)
Step Action XP
1 — Free Answer 1 clone question correctly +1 XP
2 — Ad Watch 10s ad to unlock 2 more Qs
3 — Completion Each subsequent correct answer +1 XP each
Total RecoveryUp to +3 XP
Premium ShortcutSkip ad → 60–90s Masterclass video
Olympiad & Leaderboard Ecosystem — ADR-015
CadenceFriday – Sunday (Weekend Event)
RankingAll battle XP aggregated → Global Top 10
RewardsAutomated verified certificates
CosmeticsFire Aura + Gold Profile Frame
BadgesConcept Master Badges (Masterclass progress)
Ask Zen AI Teacher Assistant