From c8b080cf97b0308f888ced98b3e2793fdd167ac0 Mon Sep 17 00:00:00 2001 From: rainxchzed Date: Mon, 2 Mar 2026 07:29:23 +0500 Subject: [PATCH 1/4] feat(docs): update README with new features and architectural improvements This commit updates the README to reflect significant enhancements across the application, including the new release browser, improved app management capabilities, and expanded platform support. - **feat(discovery)**: Added auto-scroll behavior for categories and overhaul of the search system with relevance ranking. - **feat(releases)**: Introduced a release picker to browse and install from any release version, moving beyond "latest-only" support. - **feat(details)**: Added deep linking support, developer profile screens, and a share action. - **feat(management)**: Documented new app management features including open, uninstall, and downgrade actions, alongside APK architecture matching for Android. - **feat(network)**: Added documentation for dynamic proxy support and the enhanced caching system. - **i18n**: Listed 12 newly supported languages for localization. - **feat(ux)**: Added details for Android-specific UI enhancements (splash screen, adaptive icons) and expanded Linux format support (AppImage). - **docs**: Refined the "How it works" and "Key benefits" sections to align with current functionality. --- README.md | 52 +++++++++++++++++++++++++++++++++++++--------------- 1 file changed, 37 insertions(+), 15 deletions(-) diff --git a/README.md b/README.md index c294a47f9..3ef161aa0 100644 --- a/README.md +++ b/README.md @@ -153,22 +153,40 @@ GitHub® is a registered trademark of GitHub, Inc. - 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. + - Auto‑scrolls to top when switching categories. + - Overhauled search with improved relevance ranking and performance. -- **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. +- **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. + - App name, version, “Install latest” button, and share action. - Stars, forks, open issues. - Rendered README content (“About this app”). - - Latest release notes (body) with markdown formatting. + - 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: 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. + - 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. --- @@ -217,18 +235,22 @@ automatically—no manual submission required. - 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. - - Latest release: tag, published date, body (changelog), assets. + - 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”: - - Picks the best matching asset for the current platform. - - Streams the download. + - 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. --- @@ -240,9 +262,9 @@ automatically—no manual submission required. - **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. +- **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. From c5aaaa3e6b30682c3bd3bdb03242c557357384db Mon Sep 17 00:00:00 2001 From: rainxchzed Date: Mon, 2 Mar 2026 07:33:54 +0500 Subject: [PATCH 2/4] docs: update README features and repository requirements This commit updates the README to reflect changes in the discovery sections and simplifies the repository inclusion criteria. - **docs**: Renamed home sections from "Trending", "Recently Updated", and "New" to "Trending", "Hot Release", and "Most Popular". - **docs**: Removed "Auto-scrolls to top" from the feature list. - **docs**: Updated repository requirements by removing the explicit constraint that the latest release must not be a prerelease. - **docs**: Re-indexed the requirement list and updated section references to match new category names. --- README.md | 13 ++++--------- 1 file changed, 4 insertions(+), 9 deletions(-) diff --git a/README.md b/README.md index 3ef161aa0..dab89d33f 100644 --- a/README.md +++ b/README.md @@ -150,10 +150,9 @@ GitHub® is a registered trademark of GitHub, Inc. ## 🚀 Features - **Smart discovery** - - Home sections for “Trending”, “Recently Updated”, and “New” 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. - - Auto‑scrolls to top when switching categories. - Overhauled search with improved relevance ranking and performance. - **Release browser & installs** @@ -198,11 +197,7 @@ 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** +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` @@ -211,13 +206,13 @@ Your project can appear automatically if it follows these conditions: - GitHub Store ignores GitHub’s auto‑generated source artifacts (`Source code (zip)` / `Source code (tar.gz)`). -4. **Discoverable by search / topics** +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 Popular/Updated/New sections. + - 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. From f5f604510eaaa599661720324929b115e06e169a Mon Sep 17 00:00:00 2001 From: rainxchzed Date: Mon, 2 Mar 2026 07:52:56 +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 dab89d33f..39f9811c5 100644 --- a/README.md +++ b/README.md @@ -165,7 +165,7 @@ GitHub® is a registered trademark of GitHub, Inc. - 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. + - 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. From 0808112ec40842d6ef55911417ab78a3daf024a1 Mon Sep 17 00:00:00 2001 From: rainxchzed Date: Mon, 2 Mar 2026 08:39:01 +0500 Subject: [PATCH 4/4] docs: add advocacy banner to README This commit adds a caution alert to the README to raise awareness about the "Keep Android Open" campaign. - **docs**: Added a message and link to `keepandroidopen.org` to the README. --- README.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/README.md b/README.md index 39f9811c5..84c57b1bb 100644 --- a/README.md +++ b/README.md @@ -63,6 +63,9 @@ Built with Kotlin Multiplatform and Compose Multiplatform for Android and Deskto +> [!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/). +