RepoStore

RepoStore is a GitHub-powered Android app store that discovers repositories shipping real installable APKs and lets you install, track, and update them from one place.

[!CAUTION] Free and Open-Source Android is under threat. Google will turn Android into a locked-down platform, restricting your essential freedom to install apps of your choice. Make your voice heard – keepandroidopen.org.

---

All screenshots can be found in screenshots/ folder.

✨ What is RepoStore?

RepoStore is a native Android app that turns GitHub releases into a clean, Play Store style experience:

• Only shows repositories that actually provide installable APK assets.
• Detects installed apps and shows update availability.
• Always installs from the latest published release with changelog.
• Presents a polished details screen with stats, README, and developer info.

---

🔃 Download

---

🚀 Features

• Smart Discovery

  • Home sections for "Trending", "Recently Updated", and "Featured" projects.
  • Only repos with valid APK assets are shown.
  • Category-based filtering for apps.

• Latest-Release Installs

  • Fetches /releases/latest for each repo.
  • Shows only assets from the latest release.
  • Single "Install" action with download progress.

• Rich Details Screen

  • App name, version, "Install" button.
  • Stars, forks, language stats.
  • Rendered README content ("About this app").
  • Latest release notes with markdown formatting.
  • Screenshot gallery with fullscreen viewer.

• Install & Update Tracking

  • Opens APK downloads with the package installer.
  • Tracks installations and shows "Open" for installed apps.
  • Detects when updates are available.

• Appearance & Theming

  • Material 3 design with Material You support.
  • Dark mode with system theme support.
  • Clean, Play Store inspired UI.

• GitHub Integration

  • Optional GitHub sign-in via OAuth device flow.
  • Increases API rate limit from 60 to 5,000 requests/hour.
  • View developer profiles and repositories.

• Support Developer

  • UPI payment integration with QR code.
  • Detects installed UPI apps (GPay, PhonePe, Paytm, etc.).
  • One-tap payment support.

---

❓ How does an app appear in RepoStore?

RepoStore does not use any private indexing or manual curation. Your project can appear automatically if it follows these conditions:

1. Public repository on GitHub

   • Visibility must be public.

2. At least one published release

   • Created via GitHub Releases (not only tags).
   • The latest release must not be a draft or prerelease.

3. APK assets in the latest release

   • The latest release must contain at least one .apk file.
   • GitHub's auto-generated source artifacts are ignored.

4. Discoverable by search / topics

   • Repositories are fetched via the public GitHub Search API.
   • Topics like android, mobile, apk help ranking.
   • Having stars makes it more likely to appear in sections.

If your repo meets these conditions, RepoStore can find it through search and show it automatically—no manual submission required.

---

🧭 How RepoStore Works

1. Search

   • Uses GitHub's /search/repositories endpoint with Android-focused queries.
   • Applies scoring based on topics, language, and description.
   • Filters out archived repos.

2. Release + Asset Check

   • For candidate repos, calls /repos/{owner}/{repo}/releases/latest.
   • Checks the assets array for .apk files.
   • If no APK is found, the repo is excluded from results.

3. Details Screen

   • Repository info: name, owner, description, stars, forks.
   • Latest release: tag, published date, changelog, assets.
   • README: loaded and rendered as "About this app".
   • Screenshots: detected from repository contents.

4. Install Flow

   • When user taps "Install":
     • Downloads the APK with progress indicator.
     • Delegates to the system package installer.
     • Records installation in local database.
     • Shows "Open" button for installed apps.

---

⚙️ Tech Stack

• Minimum Android SDK: 26 (Android 8.0)

• Language & Platform

  • Kotlin with Coroutines & Flow
  • Android Native with ViewBinding

• Architecture

  • MVVM (Model-View-ViewModel)
  • Repository Pattern
  • Single Activity with Fragments

• Networking & Data

  • Retrofit + OkHttp
  • Gson for JSON parsing
  • Room for local database

• UI & Design

  • Material 3 Components
  • Glide for image loading
  • Markwon for README rendering
  • PhotoView for zoomable images

• Auth & Security

  • GitHub OAuth (Device Code flow)
  • SharedPreferences for token storage

---

✅ Why Use RepoStore?

• No more hunting through GitHub releases See only repos that actually ship APKs.

• Knows what you installed Tracks apps installed via RepoStore and shows when updates are available.

• Always the latest release Installs are guaranteed to come from the latest published release.

• Play Store-like experience Familiar UI with categories, search, and app details.

• Open source & extensible Written in Kotlin with clean architecture—easy to fork and extend.

---

💖 Support This Project

RepoStore is free and always will be. If it's helped you, consider:

• ⭐ Star this repository
• 🐛 Report bugs and issues
• 💡 Suggest new features
• 💳 Donate via UPI (in-app)

Your support helps maintain the app and build new features!

---

🔑 Configuration

GitHub OAuth (Optional)

To enable GitHub sign-in for increased API limits:

1. Create a GitHub OAuth app at GitHub → Settings → Developer settings → OAuth Apps.
2. Copy the Client ID from the OAuth app.
3. Update in GitHubAuth.kt:

private const val CLIENT_ID = "your_client_id_here"

---

⚠️ Disclaimer

RepoStore only helps you discover and download release assets that are already published on GitHub by third-party developers.

The contents, safety, and behavior of those downloads are entirely the responsibility of their respective authors and distributors, not this project.

By using RepoStore, you understand and agree that you install and run any downloaded software at your own risk. This project does not review, validate, or guarantee that any APK is safe, free of malware, or fit for any particular purpose.

---

👨‍💻 Author

---

📄 License

RepoStore is released under the MIT License.

MIT License

Copyright (c) 2026 Samyak Kamble

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

---