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/latestfor each repo. - Shows only assets from the latest release.
- Single "Install" action with download progress.
- Fetches
-
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:
-
Public repository on GitHub
- Visibility must be
public.
- Visibility must be
-
At least one published release
- Created via GitHub Releases (not only tags).
- The latest release must not be a draft or prerelease.
-
APK assets in the latest release
- The latest release must contain at least one
.apkfile. - GitHub's auto-generated source artifacts are ignored.
- The latest release must contain at least one
-
Discoverable by search / topics
- Repositories are fetched via the public GitHub Search API.
- Topics like
android,mobile,apkhelp 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
-
Search
- Uses GitHub's
/search/repositoriesendpoint with Android-focused queries. - Applies scoring based on topics, language, and description.
- Filters out archived repos.
- Uses GitHub's
-
Release + Asset Check
- For candidate repos, calls
/repos/{owner}/{repo}/releases/latest. - Checks the
assetsarray for.apkfiles. - If no APK is found, the repo is excluded from results.
- For candidate repos, calls
-
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.
-
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.
- When user taps "Install":
⚙️ 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
-
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:
- Create a GitHub OAuth app at GitHub → Settings → Developer settings → OAuth Apps.
- Copy the Client ID from the OAuth app.
- 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
Samyak Kamble
📄 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.
Made with ❤️ in India
