gamification_ui 0.0.1

Headless gamification UI components for Flutter: achievements, streaks, points, and leaderboards. Bring your own state — no storage, no logic, just widgets.

0.0.1

Initial release: 17 headless components across four families, plus celebration primitives. Widgets only — no storage, no network, no game logic.

Achievement

• AchievementBadge (+ fromAchievement) — circular badge with locked/unlocked states and progress ring
• AchievementBadgeGrid — tappable badge grid with titles
• AchievementUnlockToast + showAchievementUnlockToast — slide-in unlock celebration
• AchievementProgressCard — badge, description, and animated progress bar
• AchievementDetailSheet + showAchievementDetailSheet — modal detail view

Streak

• StreakFlameCounter — pulsing flame with streak count
• StreakWeeklyCalendar — seven-day completion row
• StreakMilestoneBar — progress between streak milestones

Points

• AnimatedPointsCounter — rolling number
• PointsBalanceChip — wallet pill for app bars
• XpBar — animated XP progress bar
• LevelCard — level circle + XP bar card
• PointsHistoryList / PointsHistoryTile — signed transaction history
• TierBadge — bronze → diamond metallic tiers

Leaderboard

• LeaderboardList — medal colors for top three, current-user highlight
• LeaderboardPodium — top-three podium
• RankChangeIndicator — ▲/▼/– rank movement

Foundation

• GamificationTheme — ThemeExtension palette with ColorScheme-derived defaults
• ConfettiOverlay + ConfettiController, Shine, Pulse — celebration primitives
• Plain data models: Achievement, PointsTransaction, LeaderboardEntry, Tier