Skip to content

cfultz/retrostats-android

Repository files navigation

Retro Stats 🏆

A sleek, modern Flutter application for tracking RetroAchievements profiles, game progress, and global leaderboards. Built with a focus on deep data visualization and a premium dark-mode aesthetic.

Download the App

Get it on Obtainium Download APK

(Android Users: We highly recommend using Obtainium to install Retro Stats. It will automatically notify you and download new updates whenever we push a new release!)

📸 Screenshots

Profile Dashboard Game Details
Game Library Global Leaderboards

✨ Features

  • Global User Search: Instantly look up any RetroAchievements player with live, type-ahead API querying.
  • Deep Profile Analytics: View player ranks, Total Points, True Points, and custom Retro Ratios.
  • Game Mastery Tracking: Browse Mastered vs. Played games with visual progress bars showing hardcore and softcore achievement unlocks.
  • Fuzzy Game Search: Quickly filter through massive game libraries using multi-word substring matching.
  • Leaderboards & Comments: Dive into the top 50 rankings for any specific game and read community comments on individual achievements.
  • Premium UX: Fully customized dark theme with smooth, mobile-native page transitions forced across all platforms (including desktop).

🛠️ Tech Stack

  • Framework: Flutter / Dart
  • State Management: Stateful Widgets & shared_preferences (for local credential caching)
  • Networking: http package (RESTful API integration)
  • Backend: RetroAchievements Web API

🚀 Building & Installation

This project is configured to build highly optimized, platform-specific binaries for Android and Linux.

Prerequisites

  • Flutter SDK (^3.5.0 or higher)
  • A valid RetroAchievements account and Web API Key

Building for Android (Release)

To generate optimized, lightweight APKs tailored to specific processor architectures (drastically reducing file size from ~50MB to ~15MB):

flutter clean
flutter pub get
flutter build apk --split-per-abi

💬 Translations

This application is currently English lanugage only

Working on translating the few lines into other languages. Since RetroAchievement's itself isn't completely translated yet, will wait to make this a priority until that is further along.

⚖️ Disclaimer

Retro Stats is an independent, unofficial, open-source project. It is not affiliated with, endorsed by, sponsored by, or in any way officially connected to RetroAchievements or any of its subsidiaries or affiliates.

All retro gaming assets, achievement data, user avatars, and related imagery accessed via this application are the property of RetroAchievements and their respective owners. This app relies on the public RetroAchievements Web API, and its continued functionality is subject to their API terms of service and availability.

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors