Phase 1
Phase 2
Phase 3
Phase 4
Phase 5
Phase 6
StreetLight Study Buddy
End-to-End Product Flow — All 6 Phases
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
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
Challenge Inbox
10-min TTL • Synchronized countdown
Challenge Inbox — ADR-013 / v5.0
Card Data FieldsChallenger name/avatar, Subject, Chapter, Topic, Estimated duration
TTL10 minutes — auto-cancelled if not accepted
On AcceptSynchronized 10-second countdown → both enter battle
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
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
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)