Implement Badge System: Gamified Contributor Recognition & Achievement Framework

[madjin]

Overview

Implement a comprehensive badge and achievement system for ElizaOS contributors to recognize their contributions, milestones, and expertise areas. This system will gamify the contribution experience and provide visual recognition for different types of accomplishments.

Key Features & Scope

• Badge Categories:

  • Level milestones (e.g., Novice, Contributor, Expert, Master, Legend)
  • Activity streaks (e.g., Code Warrior, Code Gladiator, Code Legend, Code Titan, Code Immortal)
  • Contribution excellence (e.g., Bug Hunter, Feature Builder, Review Master, Documentation Guru, Test Champion, Refactor Hero)
  • Repository expertise (e.g., Core Contributor, Plugin Pioneer, Multi-Repo Master, Ecosystem Champion)
  • Community recognition (e.g., Top Contributor, Rising Star, Mentor, Helpful Commenter)
  • Technical mastery (e.g., TypeScript Expert, React Specialist, Database Architect, DevOps Engineer, Full-Stack Developer)
  • Fun/creative (e.g., Night Owl, Speedy Merge, Comeback Kid)

• Database & Backend:

  • Add user_badges and badge_definitions tables (see plan for schema)
  • Badge earning logic integrated into scoring pipeline
  • Service for awarding badges based on contributor data

• UI Integration:

  • Badge display components (src/components/ui/badge.tsx, src/components/badge-list.tsx)
  • Profile integration (src/app/profile/[username]/components/UserProfile.tsx)
  • Leaderboard highlights (src/components/leaderboard.tsx)

• Data Sources:

  • Use legacy-data/daily/contributors.json and issues.json for badge triggers

Implementation Phases

1. Database & Core Logic
2. UI Components
3. Profile & Leaderboard Integration
4. (Optional, After Buy-in): Badge notifications, detail modals, badge-based leaderboard filters

Out of Scope (Initial Rollout)

• Discord bot, external integrations
• Major refactors of scoring or user systems
• Real-time notifications (beyond UI)
• Multi-repo support if not already present

References

• BADGE_SYSTEM_IMPLEMENTATION_PLAN.md
• Key files: src/components/ui/badge.tsx, src/components/badge-list.tsx, src/app/profile/[username]/components/UserProfile.tsx, src/components/leaderboard.tsx, legacy-data/daily/contributors.json, legacy-data/daily/issues.json

---

This issue tracks the implementation of the badge system as outlined in the BADGE_SYSTEM_IMPLEMENTATION_PLAN.md.

[madjin]

Working on art designs for badges here: https://github.com/m3-org/badges