rainxchzed / GitHub-Store
A free, open-source app store for GitHub releases — browse, discover, and install apps with one click. Powered by Kotlin and Compose Multiplatform for Android & Desktop (Linux, MacOS, Windows).
AI Architecture Analysis
This repository is indexed by RepoMind. By analyzing rainxchzed/Github-Store in our AI interface, you can instantly generate complete architecture diagrams, visualize control flows, and perform automated security audits across the entire codebase.
Our Agentic Context Augmented Generation (Agentic CAG) engine loads full source files into context on-demand, avoiding the fragmentation of traditional RAG systems. Ask questions about the architecture, dependencies, or specific features to see it in action.
Repository Summary (README)
PreviewGitHub Store
🗺️ Project Overview
GitHub Store is a cross-platform app store for GitHub releases, designed to simplify discovering and installing open-source software. It automatically detects installable binaries (APK, EXE, DMG, AppImage, DEB, RPM), provides one-click installation, tracks updates, and presents repository information in a clean, app-store style interface.
Built with Kotlin Multiplatform and Compose Multiplatform for Android and Desktop platforms.
[!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.
📔 Wiki & Resources
Check out GitHub Store Wiki for FAQ and useful information
🌐 Website: github-store.org 💬 Discord: Join the community 📜 Privacy Policy: github-store.org/privacy-policy
📋 Legal Notice
GitHub Store is an independent, open-source project not affiliated with GitHub, Inc.
The name describes the app's functionality (discovering GitHub releases) and does not imply trademark ownership.
GitHub® is a registered trademark of GitHub, Inc.
🔃 Download
[!IMPORTANT] macOS Users: You may see a warning that Apple cannot verify GitHub Store. This happens because the app is distributed outside the App Store and is not notarized yet. Allow it via System Settings → Privacy & Security → Open Anyway.
🏆 Featured In
HowToMen: Top 20 Best Android Apps 2026 | Top 12 App Stores that are Better than Google Play Store
HelloGitHub: Featured Project
🚀 Features
-
Smart discovery
- Home sections for “Trending”, “Hot Release”, and “Most Popular” projects with time‑based filters.
- Only repos with valid installable assets are shown.
- Platform‑aware topic scoring so Android/desktop users see relevant apps first.
- Overhauled search with improved relevance ranking and performance.
-
Release browser & installs
- Release picker to browse and install from any release, not just the latest.
- Fetches all releases for each repository.
- Single “Install latest” action, plus an expandable list of all available releases and their installers.
- Manual install option with automatic compatibility checks.
-
Rich details screen
- App name, version, “Install latest” button, and share action.
- Stars, forks, open issues.
- Rendered README content (“About this app”).
- Release notes with Markdown formatting for any selected release.
- List of installers with platform labels and file sizes.
- Deep linking support — open repository details directly via URL.
- Developer profile screen to explore a developer’s repositories and activity.
-
App management
- Open, uninstall, and downgrade installed apps directly from GitHub Store.
- Android: APK architecture matching (armv7/armv8), package monitoring, and update tracking.
- Desktop (Windows/macOS/Linux): downloads installers to the user’s Downloads folder and opens them with the default handler.
-
Starred repositories
- Save and browse your starred GitHub repositories from within the app.
-
Network & performance
- Dynamic proxy support for configurable network routing.
- Enhanced caching system for faster loading and reduced API usage.
-
Cross‑platform UX
- Android: native splash screen, session expiration handling, and adaptive icon.
- Desktop: Linux AppImage support prioritized alongside DEB and RPM formats.
- Localized in 12 languages: English, Spanish, French, Japanese, Korean, Polish, Russian, Chinese, Bengali, Hindi, Italian, and Turkish.
🔍 How does my app appear in GitHub Store?
GitHub Store does not use any private indexing or manual curation rules.
Your project can appear automatically if it follows these conditions:
-
Public repository on GitHub
- Visibility must be
public.
- Visibility must be
-
Installable assets in the latest release
- The latest release must contain at least one asset file with a supported extension:
- Android:
.apk - Windows:
.exe,.msi - macOS:
.dmg,.pkg - Linux:
.deb,.rpm,.AppImage
- Android:
- GitHub Store ignores GitHub’s auto‑generated source artifacts (
Source code (zip)/Source code (tar.gz)).
- The latest release must contain at least one asset file with a supported extension:
-
Discoverable by search / topics
- Repositories are fetched via the public GitHub Search API.
- Topic, language, and description help the ranking:
- Android apps: topics like
android,mobile,apk. - Desktop apps: topics like
desktop,windows,linux,macos,compose-desktop,electron.
- Android apps: topics like
- Having at least a few stars makes it more likely to appear under Trending/Hot Release/Most Popular sections.
If your repo meets these conditions, GitHub Store can find it through search and show it automatically—no manual submission required.
🧭 How GitHub Store works (high‑level)
-
Search
- Uses GitHub’s
/search/repositoriesendpoint with platform‑aware queries. - Applies simple scoring based on topics, language, and description.
- Filters out archived repos and those with too few signals.
- Uses GitHub’s
-
Release + asset check
- For candidate repos, calls
/repos/{owner}/{repo}/releases/latest. - Checks the
assetsarray for platform‑specific file extensions. - If no suitable asset is found, the repo is excluded from results.
- Users can also browse all releases via the release picker.
- For candidate repos, calls
-
Details screen
- Repository info: name, owner, description, stars, forks, issues.
- Release browser: browse any release with its tag, date, changelog, and assets.
- README: loaded from the default branch and rendered as “About this app”.
- Developer profile link and share action.
- Accessible via deep links for direct navigation.
-
Install flow
- When the user taps “Install latest” or selects a specific release:
- Picks the best matching asset for the current platform (with architecture matching on Android).
- Streams the download with caching support.
- Delegates to the OS installer (APK installer on Android, default handler on desktop).
- On Android, records the installation in a local database and uses package monitoring to keep the installed list in sync.
- Supports open, uninstall, and downgrade actions for managed apps.
- When the user taps “Install latest” or selects a specific release:
✅ Pros / Why use GitHub Store?
-
No more hunting through GitHub releases See only repos that actually ship binaries for your platform.
-
Knows what you installed Tracks apps installed via GitHub Store (Android) and highlights when new releases are available, so you can update them without hunting through GitHub again.
-
Always up to date Installs default to the latest published release, with the option to browse and install from any previous release via the release picker.
-
Uniform experience across platforms
Same UI and logic for Android and desktop, with platform‑native install behavior. -
Open source & extensible
Written in KMP with a clear separation between networking, domain logic, and UI—easy to fork, extend, or adapt.
🔐 GitHub Store APK Signing Certificate
All official GitHub Store releases are signed with the following certificate fingerprint:
SHA-256:
B7:F2:8E:19:8E:48:C1:93:B0:38:C6:5D:92:DD:F7:BC:07:7B:0D:B5:9E:BC:9B:25:0A:6D:AC:48:C1:18:03:CA
🔑 GitHub OAuth Configuration
TL;DR
- Create a GitHub OAuth App
- Copy Client ID
- Put it in
local.properties
Show full setup guide
1 - Create a GitHub OAuth App
Go to: GitHub → Settings → Developer settings → OAuth Apps → New OAuth App
| Field | Value |
|---|---|
| Application name | Anything you like (e.g. GitHub Store Dev) |
| Homepage URL | https://github.com/username/repo_name |
| Authorization callback URL | githubstore://callback |
Then click Create application.
2 - Copy Your Client ID
After creating the app, GitHub will show:
- Client ID ← you need this
- Client Secret ← ❗ NOT required for this project
3 - Add It to Your Project
Open your project’s local.properties file (root of the project) and add:
GITHUB_CLIENT_ID=YOUR_CLIENT_ID_HERE
4 - Sync & Run
Sync the project and run the app. You should now be able to sign in with GitHub.
❗ Important Notes
local.propertiesis not committed to Git, so your Client ID stays local.- This project only needs the Client ID (not the Client Secret).
- Each developer should create their own OAuth app for development.
☕ Support the project
GitHub Store has reached 48,000+ active users and 5,500+ GitHub stars — and it's 100% free with no ads, no tracking, and no premium features.
I built and maintain this entirely on my own while finishing high school. Your support (even $3) helps me:
✅ Keep the app bug-free — respond to issues and ship fixes quickly
✅ Add community-requested features — implement what users actually need
✅ Maintain infrastructure — servers, APIs, and deployment costs
💖 Ways to Support
Can't sponsor right now? That's okay! You can still help by:
- ⭐ Starring this repo — helps others discover GitHub Store
- 🐛 Reporting bugs — makes the app better for everyone
- 📢 Sharing with friends — spread the word to other developers
- 💬 Joining our Discord — your feedback shapes the roadmap
Every bit of support—financial or not—means the world and keeps this project alive. Thank you!
⚠️ Disclaimer
GitHub Store 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 GithubStore, 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 installer is safe, free of malware, or
fit for any particular purpose.
Star History
📄 License
GitHub Store will be released under the Apache License, Version 2.0.
Copyright 2025 rainxchzed
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this project except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.