## 🚀 Features
- **Smart discovery**
- Home sections for “Trending”, “Recently Updated”, and “New” 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.
- **Latest‑release installs**
- Fetches `/releases/latest` for each repo.
- Shows only assets from the latest release.
- Single “Install latest” action, plus an expandable list of all installers for that release.
- **Rich details screen**
- App name, version, “Install latest” button.
- Stars, forks, open issues.
- Rendered README content (“About this app”).
- Latest release notes (body) with markdown formatting.
- List of installers with platform labels and file sizes.
- **Cross‑platform UX**
- Android: opens APK downloads with the package installer, tracks installations in a local database, and shows them in a dedicated Apps screen with update indicators.
- Desktop (Windows/macOS/Linux): downloads installers to the user’s Downloads folder and opens them with the default handler; no hidden temp locations.
- **Appearance & theming**
- Material 3 design with **Material 3 Expressive** components on all platforms.
- Material You dynamic color support on Android where available.
- Optional AMOLED black mode for dark theme on OLED devices.
- **Safety & inspection (Android)**
- Optional GitHub sign‑in via OAuth device flow for higher rate limits with minimal scopes.
- “Open in AppManager” action to inspect an APK’s permissions and trackers before installing.
---
## 🔍 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. **At least one published release**
- Created via GitHub Releases (not only tags).
- The latest release must not be a draft or prerelease.
3. **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)`).
4. **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 Popular/Updated/New 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.
3. **Details screen**
- Repository info: name, owner, description, stars, forks, issues.
- Latest release: tag, published date, body (changelog), assets.
- README: loaded from the default branch and rendered as “About this app”.
4. **Install flow**
- When the user taps “Install latest”:
- Picks the best matching asset for the current platform.
- Streams the download.
- 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.
---
## ⚙️ Tech stack
- **Minimum Android SDK: 24**
- **Language & Platform**
- [Kotlin Multiplatform](https://kotlinlang.org/docs/multiplatform.html) (Android + JVM Desktop)
- [Compose Multiplatform UI](https://www.jetbrains.com/compose-multiplatform/) ([Material 3](https://m3.material.io/),
icons, resources)
- **Async & state**
- [Kotlin Coroutines](https://kotlinlang.org/docs/coroutines-overview.html) + [Flow](https://kotlinlang.org/api/kotlinx.coroutines/kotlinx-coroutines-core/kotlinx.coroutines.flow/-flow/)
- AndroidX Lifecycle (ViewModel + Runtime Compose)
- **Networking & Data**
- [Ktor 3](https://ktor.io/) (HttpClient with OkHttp on Android, Java on Desktop)
- [Kotlinx Serialization JSON](https://github.com/Kotlin/kotlinx.serialization).
- [Kotlinx Datetime](https://github.com/Kotlin/kotlinx-datetime) for time handling
- [Room](https://developer.android.com/jetpack/androidx/releases/room) + KSP for the installed apps database on Android.
- **Dependency injection**
- [Koin 4](https://insert-koin.io/)
- **Navigation**
- [JetBrains Navigation Compose](https://kotlinlang.org/docs/multiplatform/compose-navigation.html)
for shared navigation graph
- **Auth & Security**
- GitHub OAuth (Device Code flow)
- [Androidx DataStore](https://developer.android.com/kotlin/multiplatform/datastore) for token
storage
- **Media & markdown**
- [Coil 3](https://coil-kt.github.io/coil/getting_started/) (Ktor3 image loader)
- [multiplatform-markdown-renderer-m3](https://github.com/mikepenz/multiplatform-markdown-renderer) (+
Coil3 integration) for README/release notes
- **Logging & tooling**
- [Kermit logging](https://kermit.touchlab.co/)
- [Compose Hot Reload](https://kotlinlang.org/docs/multiplatform/compose-hot-reload.html) (
desktop)
- [ProGuard/R8](https://developer.android.com/topic/performance/app-optimization/enable-app-optimization) +
resource shrinking for release builds
---
## ✅ 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 the latest release**
Installs are guaranteed to come from the latest published release; the changelog you see is
exactly what you’re installing.
- **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`
---
## ☕ 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 discussions** — your feedback shapes the roadmap
Every bit of support—financial or not—means the world and keeps this project alive. Thank you! 🙏
---
## Star History