Thanks to visit codestin.com
Credit goes to github.com

Skip to content

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

License

Notifications You must be signed in to change notification settings

OpenHub-Store/GitHub-Store


GitHub Store


API Kotlin Compose Multiplatform material





rainxchzed%2FGithub-Store | Trendshift Featured|HelloGitHub

🗺️ 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

Get it on Obtainium

Join Discord

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

Featured by HowToMen
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:

  1. Public repository on GitHub

    • Visibility must be public.
  2. 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
    • GitHub Store ignores GitHub’s auto‑generated source artifacts (Source code (zip) / Source code (tar.gz)).
  3. 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.
    • 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)

  1. Search

    • Uses GitHub’s /search/repositories endpoint with platform‑aware queries.
    • Applies simple scoring based on topics, language, and description.
    • Filters out archived repos and those with too few signals.
  2. Release + asset check

    • For candidate repos, calls /repos/{owner}/{repo}/releases/latest.
    • Checks the assets array 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.
  3. 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.
  4. 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.

✅ 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

  1. Create a GitHub OAuth App
  2. Copy Client ID
  3. 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.properties is 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

Buy Me a Coffee GitHub Sponsors

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

Star History Chart

Alt

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

About

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

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Sponsor this project

  •  

Languages