From 64eb24f8e682b753832362fa272b8cfd143efed3 Mon Sep 17 00:00:00 2001 From: nxfu Date: Sat, 25 Apr 2026 23:36:21 +0530 Subject: [PATCH 1/4] Refactor README for improved clarity and structure Updated README.md to enhance formatting and add new sections. --- README.md | 314 +++++++++++++++++++++++++++--------------------------- 1 file changed, 159 insertions(+), 155 deletions(-) diff --git a/README.md b/README.md index a6dd666fc..d5865c358 100644 --- a/README.md +++ b/README.md @@ -1,63 +1,50 @@
-
- - -
- -
+
+ # GitHub Store
-
-

- API - Kotlin - Compose Multiplatform - material - -
-
- - - - - - - - - -
-
- - - - - - - - - -
-
- + Kotlin + Apache-2.0 +
+
+ + + + +
+
+ + + + + + + + + + + + +

- OpenHub-Store%2FGitHub-Store | Trendshift + OpenHub-Store%2FGitHub-Store | Trendshift - Featured｜HelloGitHub + Featured｜HelloGitHub
-# 🗺️ Project Overview +## 🗺️ 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. @@ -68,88 +55,48 @@ Built with Kotlin Multiplatform and Compose Multiplatform for Android and Deskto ---
- -### 📺 Meet the Developer - -I made a video introducing myself and sharing what's next for GitHub Store. - -**[Watch on YouTube →](https://www.youtube.com/watch?v=iT1cok4-Txs)** | **[Watch on Bilibili →](https://www.bilibili.tv/en/video/4799266946423296)** - -Help shape the future of GitHub Store — take this 2-minute survey: - -**[📋 Take the Survey →](https://www.tally.so/r/q4Ed88)** - + + Support Palestine +
---- - -
- -
Support Palestine
- -
- > [!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](https://keepandroidopen.org/). -

- - - - - - +

+

-
+| 1 | 2 | 3 | +| --- | --- | --- | +| ![](media-resources/screenshots/mobile/01.jpg) | ![](media-resources/screenshots/mobile/02.jpg) | ![](media-resources/screenshots/mobile/03.jpg) | -# 📔 Wiki & Resources - -Check out GitHub Store [Wiki](https://github.com/OpenHub-Store/GitHub-Store/wiki) for FAQ and useful information - -🌐 **Website:** [github-store.org](https://github-store.org) -💬 **Discord:** [Join the community](https://discord.gg/x9Cvh2Z9qS) -📜 **Privacy Policy:** [github-store.org/privacy-policy](https://github-store.org/privacy-policy/) - -
+| 4 | 5 | 6 | +| --- | --- | --- | +| ![](media-resources/screenshots/mobile/04.jpg) | ![](media-resources/screenshots/mobile/05.jpg) | ![](media-resources/screenshots/mobile/06.jpg) | ---
-### 📋 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
---- -

- -# 🔃 Download -

- -

- - - - - - - -

- -

- - Get it on Obtainium - - - - Get it on GitHub Store - + + + + + + +
+ + Get it on Obtainium + + + Get it on GitHub Store +

> [!IMPORTANT] @@ -173,55 +120,31 @@ winget install zed.rainxch.githubstore --- -# Discord -You can submit any feedback in our [discord server](https://discord.gg/NBW4zeFcG6) -

- - - -

- -

- -# 🏆 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. + - 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. - Search with filters for platform, programming language, and sort order. - Search history — recent queries are saved locally and shown as suggestions. - Clipboard link detection — automatically detects GitHub URLs from your clipboard and offers quick navigation. - - Hide seen repos — optionally filter out repositories you’ve already viewed from discovery feeds. + - Hide seen repos — optionally filter out repositories you've already viewed from discovery feeds. - **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. + - 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 and share action. - Stars, forks, open issues. - - Rendered README content (“About this app”). + - 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 via `githubstore://`, `github.com`, or `github-store.org` URLs. - - Developer profile screen to explore a developer’s repositories and activity. + - Developer profile screen to explore a developer's repositories and activity. - **App management** - Open, uninstall, and downgrade installed apps directly from GitHub Store. @@ -230,12 +153,12 @@ You can submit any feedback in our [discord server](https://discord.gg/NBW4zeFcG - Android: Shizuku silent installation — install and update apps without prompts (requires [Shizuku](https://shizuku.rikka.app/) running with ADB or root). - Android: Background update checking — configurable periodic checks (3h / 6h / 12h / 24h) with notifications when updates are found. - Android: Auto‑update — silently installs available updates via Shizuku when enabled. - - Desktop (Windows/macOS/Linux): downloads installers to the user’s Downloads folder and opens them with the default handler. + - Desktop (Windows/macOS/Linux): downloads installers to the user's Downloads folder and opens them with the default handler. - **Collections** - **Starred** — browse your GitHub starred repositories from within the app. - **Favourites** — save repositories locally for quick access, no GitHub login required. - - **Recently viewed** — automatically tracks repositories you’ve opened for easy return. + - **Recently viewed** — automatically tracks repositories you've opened for easy return. - **Tweaks** - Dedicated settings screen accessible from the bottom navigation bar. @@ -251,11 +174,17 @@ You can submit any feedback in our [discord server](https://discord.gg/NBW4zeFcG - **Network & performance** - Dynamic proxy support (HTTP, SOCKS, System) for configurable network routing. - Enhanced caching system for faster loading and reduced API usage. + --- -## 🔍 How does my app appear in GitHub Store? +## FAQ -GitHub Store does not use any private indexing or manual curation rules. +
+🔍 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** @@ -267,7 +196,7 @@ Your project can appear automatically if it follows these conditions: - Windows: `.exe`, `.msi` - macOS: `.dmg`, `.pkg` - Linux: `.deb`, `.rpm`, `.AppImage` - - GitHub Store ignores GitHub’s auto‑generated source artifacts (`Source code (zip)` / + - GitHub Store ignores GitHub's auto‑generated source artifacts (`Source code (zip)` / `Source code (tar.gz)`). 3. **Discoverable by search / topics** @@ -281,9 +210,12 @@ Your project can appear automatically if it follows these conditions: If your repo meets these conditions, GitHub Store can find it through search and show it automatically—no manual submission required. ---- +
-## ✅ Pros / Why use GitHub Store? +
+✅ Pros / Why use GitHub Store? + +
- **No more hunting through GitHub releases** See only repos that actually ship binaries for your platform. @@ -308,6 +240,46 @@ automatically—no manual submission required. Written in KMP with a clear separation between networking, domain logic, and UI—easy to fork, extend, or adapt. +
+ +--- + +## 🏆 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 +

+ +--- + +## 📺 Meet the Developer + +I made a video introducing myself and sharing what's next for GitHub Store. + +**[Watch on YouTube →](https://www.youtube.com/watch?v=iT1cok4-Txs)** | **[Watch on Bilibili →](https://www.bilibili.tv/en/video/4799266946423296)** + +Help shape the future of GitHub Store — take this 2-minute survey: + +**[📋 Take the Survey →](https://tally.so/r/q4Ed88)** + +--- + +## 💬 Discord + +You can submit any feedback in our [discord server](https://discord.gg/NBW4zeFcG6) + +

+ + + +

+ --- ## 🔐 GitHub Store APK Signing Certificate @@ -322,16 +294,17 @@ SHA-256: ## 🔑 GitHub OAuth Configuration **TL;DR** -1. Create a GitHub OAuth App -2. Copy **Client ID** +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** @@ -344,20 +317,24 @@ Go to: 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: + +Open your project's `local.properties` file (root of the project) and add: ```properties 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. @@ -366,6 +343,27 @@ Sync the project and run the app. You should now be able to sign in with GitHub. --- +## 📔 Wiki & Resources + +Check out GitHub Store [Wiki](https://github.com/OpenHub-Store/GitHub-Store/wiki) for FAQ and useful information + +🌐 **Website:** [github-store.org](https://github-store.org) +💬 **Discord:** [Join the community](https://discord.gg/x9Cvh2Z9qS) +📜 **Privacy Policy:** [github-store.org/privacy-policy](https://github-store.org/privacy-policy/) + +--- + +## ❤️ Support This Project + +GitHub Store is 100% free. No ads. No tracking. + +- ⭐ **[Star](https://github.com/OpenHub-Store/GitHub-Store/star)** this repository +- 🐛 **[Report](https://github.com/OpenHub-Store/GitHub-Store/issues)** bugs and issues +- 💡 **[Suggest](https://github.com/OpenHub-Store/GitHub-Store/discussions)** new features +- 💳 **[Sponsor](https://github.com/sponsors/rainxchzed)** the developer + +--- + ## 💼 Business Inquiries GitHub Store is open to partnerships, sponsorships, and integrations. @@ -377,19 +375,23 @@ If you're interested in working together, reach out: --- -⭐ **Like GitHub Store?** Star this repo to help others discover it. +## 📋 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. --- ## ⚠️ Disclaimer GitHub Store only helps you discover and download release assets that are already published on -GitHub by third‑party developers. +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 GitHub Store, you understand and agree that you install and run any downloaded software at -your own risk. +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. @@ -398,15 +400,17 @@ fit for any particular purpose. ## Star History - - - - Star History Chart - + + + + Star History Chart + ![Alt](https://repobeats.axiom.co/api/embed/20367dca127572e9c47db33850979d78df2c6a8b.svg "Repobeats analytics image") +--- + ## 📄 License GitHub Store is released under the **Apache License, Version 2.0**. From 1b92692fc521dc000cd17002faf8c6acb38930b4 Mon Sep 17 00:00:00 2001 From: "Usmon N." Date: Sun, 26 Apr 2026 15:07:32 +0500 Subject: [PATCH 2/4] Add alt text to badges in README.md Updated badge links in README.md to include alt text. --- README.md | 24 ++++++++++++------------ 1 file changed, 12 insertions(+), 12 deletions(-) diff --git a/README.md b/README.md index d5865c358..8d163e190 100644 --- a/README.md +++ b/README.md @@ -17,18 +17,18 @@

- - - - - - - - - - - - + + Downloads + + + Stars + + + Issues + + + Latest release +

From 1f7443782878478352fca73cb02c3449e56c5d0d Mon Sep 17 00:00:00 2001 From: "Usmon N." Date: Sun, 26 Apr 2026 15:14:51 +0500 Subject: [PATCH 3/4] Update README.md Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com> --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 8d163e190..634eacd25 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,6 @@

- + GitHub Store app icon # GitHub Store From 26d4b99d1c8bf90fe0a93647979d7a43d093597c Mon Sep 17 00:00:00 2001 From: "Usmon N." Date: Sun, 26 Apr 2026 18:57:56 +0500 Subject: [PATCH 4/4] Revise README with updated badges and new sections Updated badge links and added new sections for features, FAQ, and project support. --- README.md | 63 +++++++++++++++++++++++++++++++++++++++++++++++++++---- 1 file changed, 59 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index 634eacd25..db054ac0d 100644 --- a/README.md +++ b/README.md @@ -18,7 +18,7 @@

- Downloads + Downloads Stars @@ -27,7 +27,7 @@ Issues - Latest release + Latest release

@@ -120,8 +120,12 @@ winget install zed.rainxch.githubstore --- +
+ ## 🚀 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. @@ -177,7 +181,11 @@ winget install zed.rainxch.githubstore --- -## FAQ +
+ + ## FAQ + +
🔍 How does my app appear in GitHub Store? @@ -244,8 +252,12 @@ automatically—no manual submission required. --- +
+ ## 🏆 Featured In +
+

Featured by HowToMen @@ -258,8 +270,12 @@ automatically—no manual submission required. --- +

+ I made a video introducing myself and sharing what's next for GitHub Store. **[Watch on YouTube →](https://www.youtube.com/watch?v=iT1cok4-Txs)** | **[Watch on Bilibili →](https://www.bilibili.tv/en/video/4799266946423296)** @@ -270,8 +286,12 @@ Help shape the future of GitHub Store — take this 2-minute survey: --- +
+ ## 💬 Discord +
+ You can submit any feedback in our [discord server](https://discord.gg/NBW4zeFcG6)

@@ -282,8 +302,12 @@ You can submit any feedback in our [discord server](https://discord.gg/NBW4zeFcG --- +

+ ## 🔐 GitHub Store APK Signing Certificate +
+ All official GitHub Store releases are signed with the following certificate fingerprint: SHA-256: @@ -291,8 +315,12 @@ SHA-256: --- +
+ ## 🔑 GitHub OAuth Configuration +
+ **TL;DR** 1. Create a GitHub OAuth App 2. Copy **Client ID** @@ -343,8 +371,12 @@ Sync the project and run the app. You should now be able to sign in with GitHub. --- +
+ ## 📔 Wiki & Resources +
+ Check out GitHub Store [Wiki](https://github.com/OpenHub-Store/GitHub-Store/wiki) for FAQ and useful information 🌐 **Website:** [github-store.org](https://github-store.org) @@ -353,8 +385,12 @@ Check out GitHub Store [Wiki](https://github.com/OpenHub-Store/GitHub-Store/wiki --- +
+ ## ❤️ Support This Project +
+ GitHub Store is 100% free. No ads. No tracking. - ⭐ **[Star](https://github.com/OpenHub-Store/GitHub-Store/star)** this repository @@ -364,8 +400,12 @@ GitHub Store is 100% free. No ads. No tracking. --- +
+ ## 💼 Business Inquiries +
+ GitHub Store is open to partnerships, sponsorships, and integrations. If you're interested in working together, reach out: @@ -375,16 +415,23 @@ If you're interested in working together, reach out: --- +
+ ## 📋 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. --- +
+ ## ⚠️ 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 @@ -397,7 +444,11 @@ fit for any particular purpose. --- -## Star History +
+ +## 💫 Star History + +
 @@ -411,8 +462,12 @@ fit for any particular purpose. --- +
+ ## 📄 License +
+ GitHub Store is released under the **Apache License, Version 2.0**. ```