Orion Store

A transparent app store built around public releases, inspectable metadata, and automation you can actually follow.

  

Sources Supported

Overview :milky_way:

Orion Store is an Android-first store client that leans on public sources instead of hiding everything behind a private service layer. The app pulls catalog data from public JSON, resolves releases from GitHub, GitLab, and Codeberg, and keeps the delivery path understandable enough that users can see where things come from and how updates are discovered.

This repository is the client application itself. The live catalog, configuration, notices, and release metadata used by the app are maintained separately in RookieEnough/Orion-Data, which keeps the UI and the store data cleanly separated.

Orion is built for people who care where software comes from, not just how quickly it downloads.

At a glance:

• Public JSON catalog with inspectable configuration
• Multi-source releases (GitHub, GitLab, Codeberg)
• Android-native install, update, and security tooling

What makes Orion different :sparkles:

The point of Orion is not to pretend infrastructure does not exist. It is to reduce hidden infrastructure and move as much of the important behavior as possible into public, inspectable layers. Catalog entries are plain data. Release sources stay visible. Automation is handled through workflows and workers that can be reviewed, rather than through a black-box backend that users have to trust on faith.

That design carries through the app. Orion tracks installed packages, surfaces updates, manages download state, supports install flows on Android, and exposes developer-facing diagnostics for people who want to see what the store is actually doing under the hood.

Feature atlas :rocket:

Rather than treating Orion like a download button with a search bar, the app is built as a complete release-aware client. The best way to explain it is to show the major capabilities as systems, not as a long checklist.

Source support :satellite:

Orion treats multiple upstream platforms as first-class citizens, which matters because app distribution should not depend on a single forge being the only path worth supporting.

• GitHub is the primary release path and the center of most automation.
• GitLab is supported for repository metadata and raw release sourcing.
• Codeberg is supported as a real upstream, not a decorative fallback.

Screenshots / UI preview :framed_picture:

The app leans into a compact, card-driven interface with a dark shell, loud accents, and clear state changes for downloads, updates, and tools. Here is the actual gallery from the project assets:

Official Developer Badges :trophy:

If you are a developer, you can promote that your application is hosted on Orion Store by adding our official badge to your repository's readme or your product website.

How to Get Your Badge Integration Link:

1. Submit Your App: Submit your application to the Orion Store via this client or our repository submission form.
2. Enable Developer Mode: Once approved and live in the store, open Orion Store, go to the header settings (or tap the "Orion Store" header 8 times) to unlock Developer Mode.
3. Copy Integration Code: Go to your app's detail view, scroll down to the Developer Deep Links section, and click to expand it. From there, copy the Markdown Badge for your repository's README or the HTML Badge code for your website.

How the project is structured :compass:

The application is built with React, TypeScript, Vite, Tailwind CSS, and Capacitor 7. The main app shell lives in App.tsx, the UI is split across components/, persistent client state is managed in store/, Android-native functionality is bridged through plugins/AppTracker.ts, and heavier background work is pushed into workers/ for release aggregation, relay logic, image handling, and Sentinel support.

The repository also includes a bundled apps.json fallback so the client can still run with local data when needed. In normal operation, though, Orion is designed to consume public remote data and public release metadata rather than rely on a private API server.

Local development :hammer_and_wrench:

For day-to-day UI work, the web build is enough:

npm install
npm run dev

If you want a production build or a quick type check, use:

npm run build
npm run lint

Android-specific features such as package detection, native downloads, installation handoff, Shizuku integration, and most of the security tooling depend on the Capacitor plugin and only work in the Android shell. To run that version, build the web assets and sync the native project:

npm run build
npx cap sync android

After that, open android/ in Android Studio and run the app on a device.

Data, workers, and automation :robot:

Orion is best understood as backend-light rather than backend-free. The catalog and remote configuration are public, but the project still uses a few narrow pieces of infrastructure where they make sense. This repo includes Cloudflare worker code for things like leaderboard relay, image proxying, delta aggregation, submission handling, and Sentinel support. The automation story continues in .github/workflows/, where mirrors, submissions, leaderboard processing, deployment, and threat updates are handled through GitHub Actions.

That split is intentional. The app stays focused on the client, while the data and automation layers remain separately inspectable.

Contributing :handshake:

Contributions are welcome, especially in the areas that matter most to a store client: installer reliability, release resolution, UI polish, Android behavior, security tooling, and documentation. If you are changing catalog entries or store metadata, that work usually belongs in the data repository or the submission flow rather than in this client codebase.

If you want to understand the moving parts before opening a change, start with App.tsx, plugins/AppTracker.ts, workers/core.worker.ts, and the workflow files under .github/workflows/. That path gives a good overview of how the store loads data, resolves releases, and automates maintenance.

Community :speech_balloon:

The project lives across a few public surfaces:

• Orion-Data: github.com/RookieEnough/Orion-Data
• Discord: discord.com/invite/CrM6y4ujnq
• Ko-fi: ko-fi.com/rookie_z
• PayPal: paypal.me/RookieEnough
• UPI ID: rookiez@ptyes

---

Made with 💜 by RookieZ

🌌 Orion Store v1.4.0 Release

Orion Store 1.4.0 introduces intelligent Device Architecture Detection in the APK variant selector, automatic Recommended Architecture Matching, smooth high-FPS selector interactions, and full system settings alignment (versionCode 13).

---

⚡ What's New in v1.4.0

📱 Intelligent Device Architecture Detection (New Feature!)

• Hardware Architecture Detection: The Architecture Selector modal now reads your phone's processor ABI directly from the Android operating system (Build.SUPPORTED_ABIS), showing your exact CPU architecture (e.g., ARM64 (arm64-v8a) or ARMv7 (armeabi-v7a)).
• "Recommended" Variant Matching: Orion Store automatically analyzes available APK variants and highlights the best match for your phone with a Recommended badge.
• Smart Sorting: Compatible APKs are dynamically sorted to the top of the list, making 1-tap downloads fast, intuitive, and error-proof.
• Universal & Fallback Support: Universal APKs and compatible 32-bit fallback binaries are clearly tagged so you always know what runs best on your device.

🚀 Performance & UI Optimizations

• Instant Variant Modal Rendering: Native architecture calls are cached after initial query, ensuring instant modal popups with zero UI freeze.
• Optimized Dialog Lifecycles: Touch/pointer listeners and modal transitions tuned for buttery 120Hz displays.
• Cleaned Up Dependencies: Removed redundant type assertions and optimized data flow across components.

🛠️ Bug Fixes & System Alignment

• Version Alignment: Version updated to 1.4.0 across package.json, android/app/build.gradle (versionCode 13, versionName 1.4.0), and App.tsx (CURRENT_STORE_VERSION = 1.4.0) so Android System Settings accurately reflects the release version.
• Test Suite Expansion: Added unit test coverage for architecture normalization, ABI compatibility rules, and detection fallbacks (31/31 unit tests passing).

---

📱 Android Devices

1. Download OrionStore_1.4.0.apk below.
2. Install directly over your existing installation to keep all your settings, downloaded APKs, and favorites intact.
3. If using Shizuku, background installer services will seamlessly recognize the updated versionCode 13.

---

🛡️ Technical Specifications

---

Built with ❤️ by RookieZ
Serverless • Open Source • Privacy-First App Store