Skip to content

Add badge and polish & concise README #323

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
rainxchzed merged 9 commits into from
Mar 13, 2026
Merged

Add badge and polish & concise README #323

Show file tree
Hide file tree
Changes from 6 commits
Commits
Show all changes
9 commits
Select commit Hold shift + click to select a range
0066373
Update repository references and reorganize documentation assets
rainxchzed Mar 13, 2026
6f1f43d
Update indentation in README.md
rainxchzed Mar 13, 2026
350e349
Update README layout and badge styling
rainxchzed Mar 13, 2026
816d885
Update README badge layout and GitHub Store badge size
rainxchzed Mar 13, 2026
a3e58ad
Update README.md layout and download button size
rainxchzed Mar 13, 2026
44d921c
Update GitHub Store download badge height in README
rainxchzed Mar 13, 2026
57c14f4
Update Russian README with asset path changes and content refinements
rainxchzed Mar 13, 2026
e916500
Update Spanish README (README-ES.md)
rainxchzed Mar 13, 2026
c4dd609
Update README localization and resource links
rainxchzed Mar 13, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
124 changes: 41 additions & 83 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<div align="center">
</br>
<img src="./composeApp/src/commonMain/composeResources/drawable/app-icon.png" width="200" />
<img src="media-resources/app_icon.png" width="200" />
Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai Bot Mar 13, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

Add alt text to changed images for accessibility compliance.

Several changed <img> tags (e.g., Line 3, Line 24, Line 72) are missing alt, which triggers MD045 and reduces screen-reader usability.

Suggested fix pattern 
-<img src="media-resources/app_icon.png" width="200" />
+<img src="media-resources/app_icon.png" alt="GitHub Store app icon" width="200" />

-<img src="https://img.shields.io/github/downloads/OpenHub-Store/GitHub-Store/total?..."/>
+<img src="https://img.shields.io/github/downloads/OpenHub-Store/GitHub-Store/total?..." alt="Total downloads badge"/>

-<img src="media-resources/screenshots/mobile/01.jpg" width="18%" />
+<img src="media-resources/screenshots/mobile/01.jpg" alt="Mobile screenshot 1" width="18%" />

Also applies to: 24-24, 27-27, 36-36, 72-76, 112-112

🧰 Tools
🪛 markdownlint-cli2 (0.21.0)

[warning] 3-3: Images should have alternate text (alt text)

(MD045, no-alt-text)

🤖 Prompt for AI Agents 
Verify each finding against the current code and only fix it if needed.

In `@README.md` at line 3, Several <img> tags in README.md (for example the image
with src "media-resources/app_icon.png" and other images around lines noted in
the review) are missing alt attributes and trigger MD045; update each <img>
element to include a meaningful alt="..." describing the image (e.g., alt="App
icon" for media-resources/app_icon.png) so screen readers can convey the
content, ensuring all instances mentioned (lines ~3, 24, 27, 36, 72-76, 112) get
appropriate alt text that is concise and descriptive.


</div>

Expand All @@ -13,26 +13,27 @@
</br>

<p align="center">
<img alt="API" src="https://img.shields.io/badge/Api%2024+-50f270?logo=android&logoColor=black&style=for-the-badge"/></a>
<img alt="Kotlin" src="https://img.shields.io/badge/Kotlin-Multiplatform-a503fc?logo=kotlin&logoColor=white&style=for-the-badge"/></a>
<img alt="Compose Multiplatform" src="https://img.shields.io/static/v1?style=for-the-badge&message=Compose+Multiplatform&color=4285F4&logo=Jetpack+Compose&logoColor=FFFFFF&label="/></a>
<img alt="material" src="https://custom-icon-badges.demolab.com/badge/material%20you-lightblue?style=for-the-badge&logoColor=333&logo=material-you"/></a>
</br>
</br>
<img alt="API" src="https://img.shields.io/badge/Api%2024+-50f270?logo=android&logoColor=black&style=for-the-badge"/>
<img alt="Kotlin" src="https://img.shields.io/badge/Kotlin-Multiplatform-a503fc?logo=kotlin&logoColor=white&style=for-the-badge"/>
<img alt="Compose Multiplatform" src="https://img.shields.io/static/v1?style=for-the-badge&message=Compose+Multiplatform&color=4285F4&logo=Jetpack+Compose&logoColor=FFFFFF&label="/>
<img alt="material" src="https://custom-icon-badges.demolab.com/badge/material%20you-lightblue?style=for-the-badge&logoColor=333&logo=material-you"/>

</br>
</br>

<img src="https://img.shields.io/github/downloads/rainxchzed/GitHub-Store/total?color=aeff4d&style=for-the-badge&logo=data%3Aimage%2Fsvg%2Bxml%3Bbase64%2CPHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCI+PHRpdGxlPmRvd25sb2FkPC90aXRsZT48cGF0aCBkPSJNNSwyMEgxOVYxOEg1TTE5LDlIMTVWM0g5VjlINUwxMiwxNkwxOSw5WiIgZmlsbD0id2hpdGUiIC8+PC9zdmc+&label=Downloads&labelColor=4b731a"/>
<img src="https://img.shields.io/github/downloads/OpenHub-Store/GitHub-Store/total?color=aeff4d&style=for-the-badge&logo=data%3Aimage%2Fsvg%2Bxml%3Bbase64%2CPHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCI+PHRpdGxlPmRvd25sb2FkPC90aXRsZT48cGF0aCBkPSJNNSwyMEgxOVYxOEg1TTE5LDlIMTVWM0g5VjlINUwxMiwxNkwxOSw5WiIgZmlsbD0id2hpdGUiIC8+PC9zdmc+&label=Downloads&labelColor=4b731a"/>

<a href="https://github.com/rainxchzed/Github-Store/stargazers">
<img src="https://img.shields.io/github/stars/rainxchzed/Github-Store?color=ffff00&style=for-the-badge&labelColor=a1a116&logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCI+PHRpdGxlPnN0YXI8L3RpdGxlPjxwYXRoIGQ9Ik0xMiwxNy4yN0wxOC4xOCwyMUwxNi41NCwxMy45N0wyMiw5LjI0TDE0LjgxLDguNjJMMTIsMkw5LjE5LDguNjJMMiw5LjI0TDcuNDUsMTMuOTdMNS44MiwyMUwxMiwxNy4yN1oiIGZpbGw9IndoaXRlIiAvPjwvc3ZnPg=="/>
<a href="https://github.com/OpenHub-Store/GitHub-Store/stargazers">
<img src="https://img.shields.io/github/stars/OpenHub-Store/GitHub-Store?color=ffff00&style=for-the-badge&labelColor=a1a116&logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCI+PHRpdGxlPnN0YXI8L3RpdGxlPjxwYXRoIGQ9Ik0xMiwxNy4yN0wxOC4xOCwyMUwxNi41NCwxMy45N0wyMiw5LjI0TDE0LjgxLDguNjJMMTIsMkw5LjE5LDguNjJMMiw5LjI0TDcuNDUsMTMuOTdMNS44MiwyMUwxMiwxNy4yN1oiIGZpbGw9IndoaXRlIiAvPjwvc3ZnPg=="/>
</a>

<img src="https://img.shields.io/badge/65K+-Users-8ce2ff?style=for-the-badge&logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCI+PHRpdGxlPmFjY291bnQtZ3JvdXA8L3RpdGxlPjxwYXRoIGQ9Ik0xMiwxMi43NUM3LDEyLjc1IDMsMTMuMzUgMywxNi4yNVYxOEgyMVYxNi4yNUMyMSwxMy4zNSAxNywxMi43NSAxMiwxMi43NU0xNyw3QTE3LDE3IDAgMCwxIDE3LDdNMjEsMTYuMjVWMThIMjRWMTYuMjVDMjQsMTQuNDMgMjEuNSwxMy44NyAxOSwxMy41QzIwLjEyLDE0LjEgMjEsMTUgMjEsMTYuMjVNMiw3QTIsMiAwIDAsMSA0LDVIMjBBMiwyIDAgMCwxIDIyLDdBMiwyIDAgMCwxIDIwLDlINEEyLDIgMCAwLDEgMiw3TTEyLDEwQTMsMyAwIDAsMSA5LDdBMywzIDAgMCwxIDEyLDRBMywzIDAgMCwxIDE1LDdBMywzIDAgMCwxIDEyLDEwWiIgZmlsbD0id2hpdGUiIC8+PC9zdmc+&labelColor=0782ab"/>

</br>
</br>

<a href="https://github.com/rainxchzed/Github-Store/releases/latest">
<img src="https://img.shields.io/github/v/release/rainxchzed/Github-Store?color=a1168e&include_prereleases&logo=github&style=for-the-badge&labelColor=700f63"/>
<a href="https://github.com/OpenHub-Store/GitHub-Store/releases/latest">
<img src="https://img.shields.io/github/v/release/OpenHub-Store/GitHub-Store?color=a1168e&include_prereleases&logo=github&style=for-the-badge&labelColor=700f63"/>
</a>

<a href="https://f-droid.org/packages/zed.rainxch.githubstore">
Expand All @@ -46,7 +47,7 @@
<p align="center">
<a href="https://trendshift.io/repositories/22313" target="_blank"><img src="https://trendshift.io/api/badge/repositories/22313" alt="OpenHub-Store%2FGitHub-Store | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a>

<a href="https://hellogithub.com/en/repository/rainxchzed/Github-Store" target="_blank">
<a href="https://hellogithub.com/en/repository/OpenHub-Store/GitHub-Store" target="_blank">
<img src="https://abroad.hellogithub.com/v1/widgets/recommend.svg?rid=rainxchzed%2FGithub-Store&claim_uid=&theme=dark" alt="Featured｜HelloGitHub" style="width: 250px; height: 54px;" width="250" height="54" />
</a>
</p>
Expand All @@ -68,18 +69,18 @@ Built with Kotlin Multiplatform and Compose Multiplatform for Android and Deskto

<p align="middle">
<img src="media-resources/banner.jpeg" width="99%" />
<img src="media-resources/01.jpg" width="18%" />
<img src="media-resources/02.jpg" width="18%" />
<img src="media-resources/03.jpg" width="18%" />
<img src="media-resources/04.jpg" width="18%" />
<img src="media-resources/05.jpg" width="18%" />
<img src="media-resources/screenshots/mobile/01.jpg" width="18%" />
<img src="media-resources/screenshots/mobile/02.jpg" width="18%" />
<img src="media-resources/screenshots/mobile/03.jpg" width="18%" />
<img src="media-resources/screenshots/mobile/04.jpg" width="18%" />
<img src="media-resources/screenshots/mobile/05.jpg" width="18%" />
</p>

<div align="center">

# 📔 Wiki & Resources

Check out GitHub Store [Wiki](https://github.com/rainxchzed/Github-Store/wiki) for FAQ and useful information
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)
Expand All @@ -101,27 +102,28 @@ GitHub® is a registered trademark of GitHub, Inc.

---

<div align="center">
<p align="center">

# 🔃 Download

</div>
</p>

<p align="center">
<a href="https://github.com/rainxchzed/Github-Store/releases">
<img src="https://i.ibb.co/q0mdc4Z/get-it-on-github.png" height="80"/>
<a href="https://github.com/OpenHub-Store/GitHub-Store/releases">
<img src="https://i.ibb.co/q0mdc4Z/get-it-on-github.png" height="70"/>
</a>

<a href="https://f-droid.org/en/packages/zed.rainxch.githubstore/">
<img src="https://f-droid.org/badge/get-it-on.png" height="80"/>
</a>
<a href="https://apps.obtainium.imranr.dev/redirect.html?r=obtainium://add/https://github.com/rainxchzed/Github-Store/">
<img src="https://raw.githubusercontent.com/ImranR98/Obtainium/main/assets/graphics/badge_obtainium.png" height="60" alt="Get it on Obtainium">
</a>
</p>

<p align="center">
<a href="https://discord.gg/x9Cvh2Z9qS">
<img src="https://img.shields.io/badge/Discord-Join%20Community-5865F2?style=for-the-badge&logo=discord&logoColor=white" alt="Join Discord">
<a href="https://apps.obtainium.imranr.dev/redirect.html?r=obtainium://add/https://github.com/OpenHub-Store/GitHub-Store/">
<img src="https://raw.githubusercontent.com/ImranR98/Obtainium/main/assets/graphics/badge_obtainium.png" height="60" alt="Get it on Obtainium">
</a>

<a href="https://github-store.org/app?repo=OpenHub-Store/GitHub-Store">
<img src="media-resources/ghs_download_badge.png" alt="Get it on GitHub Store" height="64">
</a>
</p>

Expand All @@ -130,20 +132,18 @@ GitHub® is a registered trademark of GitHub, Inc.

---

<div align="center">
<p align="center">

# 🏆 Featured In

</div>

</p>
<p align="center">
<a href="https://www.youtube.com/@howtomen">
<img src="https://img.shields.io/badge/HowToMen-red?style=for-the-badge&logo=youtube&logoColor=white" alt="Featured by HowToMen">
</a>
</br>
<strong>HowToMen:</strong> <a href="https://www.youtube.com/watch?v=7favc9MDedQ">Top 20 Best Android Apps 2026</a> | <a href="https://www.youtube.com/watch?v=VR-MEwPDw4k">Top 12 App Stores that are Better than Google Play Store </a>
</br>
<strong>HelloGitHub:</strong> <a href="https://hellogithub.com/en/repository/rainxchzed/Github-Store">Featured Project</a>
<strong>HelloGitHub:</strong> <a href="https://hellogithub.com/en/repository/OpenHub-Store/GitHub-Store">Featured Project</a>
</p>

---
Expand All @@ -163,7 +163,7 @@ GitHub® is a registered trademark of GitHub, Inc.
- Manual install option with automatic compatibility checks.

- **Rich details screen**
- App name, version, “Install latest” button, and share action.
- App name, version and share action.
- Stars, forks, open issues.
- Rendered README content (“About this app”).
- Release notes with Markdown formatting for any selected release.
Expand All @@ -182,12 +182,6 @@ GitHub® is a registered trademark of GitHub, Inc.
- **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?
Expand Down Expand Up @@ -220,36 +214,6 @@ 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**
Expand All @@ -262,9 +226,6 @@ automatically—no manual submission required.
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.
Expand Down Expand Up @@ -329,13 +290,10 @@ Sync the project and run the app. You should now be able to sign in with GitHub.

## ☕ 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:
GitHub Store is built and maintained by high school student. Your support helps him:
Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai Bot Mar 13, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

Fix minor wording issues in support section.

Line 293 is missing an article (“a high school student”), and Line 311 reads awkwardly (“tech and non-tech buddies”).

Suggested wording 
-GitHub Store is built and maintained by high school student. Your support helps him:
+GitHub Store is built and maintained by a high school student. Your support helps him:

-- 📢 **Sharing with friends** — spread the word to other developers and tech and non-tech buddies!
+- 📢 **Sharing with friends** — spread the word to developers and non-technical friends!

Also applies to: 311-311

🤖 Prompt for AI Agents 
Verify each finding against the current code and only fix it if needed.

In `@README.md` at line 293, Update the two awkward phrases in the README: change
"GitHub Store is built and maintained by high school student." to "GitHub Store
is built and maintained by a high school student." and replace "tech and
non-tech buddies" with a clearer phrase such as "technical and non‑technical
friends" (locate the exact occurrences by searching for those strings in the
README and update them accordingly).


✅ **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

Expand All @@ -350,7 +308,7 @@ I built and maintain this entirely on my own while finishing high school. Your s
**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
- 📢 **Sharing with friends** — spread the word to other developers and tech and non-tech buddies!
- 💬 **Joining our [Discord](https://discord.gg/x9Cvh2Z9qS)** — your feedback shapes the roadmap

Every bit of support—financial or not—means the world and keeps this project alive. Thank you!
Expand All @@ -373,11 +331,11 @@ fit for any particular purpose.

## Star History

<a href="https://www.star-history.com/#rainxchzed/Github-Store&type=timeline&legend=top-left">
<a href="https://www.star-history.com/#OpenHub-Store/GitHub-Store&type=timeline&legend=top-left">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=rainxchzed/Github-Store&type=timeline&theme=dark&legend=top-left" />
<source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=rainxchzed/Github-Store&type=timeline&legend=top-left" />
<img alt="Star History Chart" src="https://api.star-history.com/svg?repos=rainxchzed/Github-Store&type=timeline&legend=top-left" />
<source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=OpenHub-Store/GitHub-Store&type=timeline&theme=dark&legend=top-left" />
<source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=OpenHub-Store/GitHub-Store&type=timeline&legend=top-left" />
<img alt="Star History Chart" src="https://api.star-history.com/svg?repos=OpenHub-Store/GitHub-Store&type=timeline&legend=top-left" />
</picture>
</a>

Expand Down
Loading