Repo Store

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.

🚀 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, and "Install" button. - Stars, forks, and language breakdown. - 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.

✅ 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.