What It Is
A multi-layered leaderboard system designed to transform individual study into social, gamified competition. It ranks students across different dimensions to motivate consistent engagement and foster learning communities.
📊 The Three-Tiered Ranking Structure
Purpose: Encourage mastery in specific courses
- Top 15 performers per subject
- Dedicated subject leaderboard pages
Purpose: Track overall platform standing
- Paginated results for browsing through thousands of learners
- Global rankings page and mobile API endpoints
Purpose: Foster friendly competition within social circles
- Real-time updates as friends progress
- Friends leaderboard views and social features
🏆 Subject Leaderboard Preview
🧬 Biology - Top 5 Performers
🌍 Global Leaderboard Preview
🏅 Top 5 Overall Learners
👥 Friends Leaderboard Preview
🤝 Your Circle - This Week
⚙️ Technical Implementation
API Endpoints
leaderboard(request) – Renders subject-based leaderboard pages with weighted scoring
leaderboards_global_paginated(request) – API endpoint for global XP rankings
leaderboards_friends(request) – API endpoint for friends-only XP comparisons
📍 Where It Appears Across the Platform
💭 Design Philosophy
Leaderboards serve multiple psychological needs:
Competitive Drive
Global rankings for broad comparison
Social Connection
Friends leaderboard for meaningful peer competition
Skill Development
Subject-specific rankings to encourage focused mastery
Progress Visibility
Clear metrics show tangible growth over time
⚖️ Balancing Competition with Community
The system intentionally avoids creating purely extrinsic motivation by:
- ✅ Celebrating multiple types of achievement (accuracy, consistency, persistence)
- ✅ Balancing competition with community through friends-only views
- ✅ Integrating with the broader XP and leveling system for holistic progression
"By making progress visible and social, the leaderboard system transforms solitary studying into a shared journey. Students don't just compete—they inspire each other, form study groups around subject rankings, and celebrate collective growth."
🎯 Impact on Learning Culture
💡 Weighted Score Formula
Subject Score = (Accuracy% × 100) + (Consistency Bonus × 10)
Where Consistency Bonus rewards multiple attempts over time
💡 The Core Insight
The most effective leaderboards don't just rank—they reveal pathways to improvement. By showing students exactly where they stand and who's ahead, we transform abstract competition into concrete, achievable goals.