- Kotlin 60.9%
- JavaScript 18.9%
- Python 12.1%
- CSS 5.1%
- HTML 2.8%
- Other 0.2%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
| app | ||
| art | ||
| assets | ||
| server | ||
| site | ||
| .gitignore | ||
| LICENSE | ||
| README.md | ||
An app store for Android, from the people behind MargyT. Open source apps and mods only. Mods are built right on the phone.
Margy Store is what Margy Patcher grew into. It keeps the patcher's package name and its signing key, so it installs over Margy Patcher and keeps everything it had: no need to remove anything first. Android 8 and up. No root.
It opens on the Margy team's own apps — MargyT, MargyT Lite, MargyC — and the whole store is one tap away. Everything in it links to its source code: an app whose source cannot be read is not let in.
The same store is on the web at margy.narez.xyz, with the same accounts. A link to an app or a person there is a link to the same page in the app: with the store on the phone, it opens there.
What it does
Mods, made on the phone
A mod of somebody else's app cannot be handed out whole: the app is not ours to redistribute. So a mod here is a patch: the store fetches the original apk the patch is for, checks it by its hash, applies the patch, and hands Android the result to install. The original can come from a mirror the release names, or from a file already on the phone.
A new version of the mod can be built on a new version of the original app, and the store simply fetches the new original. Anything that is ours outright is handed out as a plain apk, and that is checked by its hash too.
Accounts: Telegram and Google
No passwords. Signing in goes through Telegram (the project's bot says who pressed Start) or through Google (in the browser, so it works on phones without Google's services). Either can be linked to the other afterwards, and the first time somebody signs in they choose their nick.
Whoever is in the supporters' group on Telegram gets the supporter's badge and early versions.
Reviews, as a store has them
One review each per app, and the stars belong to the review: a tap on a star only picks it, and nothing counts until the review is posted. A review can be changed or deleted, and its stars go with it.
Reviews can be liked and disliked and sorted by either. The app's author can answer one under it, and when the author likes or dislikes a review, that shows on it apart from everybody else's.
Badges
The same badges as in MargyT, with the same pictures painted in their own colours. They show next to a name everywhere: in reviews, on profiles, in messages.
Messages
Anybody can be written to from their profile, unless they turned that off. Somebody new gets three messages until the other side accepts the conversation, and an unaccepted request does not say it was read. Messages take reactions, can be copied, and a few emoji on their own are shown big, as in Telegram.
Publishing your own app
Anybody signed in can submit an app or a mod: a name, a package, a link to the source, a licence. Once it is reviewed the app has its page and its author uploads its releases, with an icon, a cover, a description in Markdown and in three languages, and buttons of their own (a link, or a window of text).
A request waiting for review can already be looked at by those who chose to: Settings → Show unreviewed apps asks once more and then adds a tab for them. Rejected requests are never shown.
How it is built
app/ |
the Android app: Kotlin and Compose, Material 3 |
app/core/ |
the patch format and the code that applies it, plain Kotlin |
server/store.py |
the server: Python's standard library and one SQLite file |
site/web/ |
the store on the web: one page, no framework |
site/store/ |
the privacy policy and the terms |
assets/ |
the banner, and the script that draws it |
art/ |
the logo |
The server runs behind nginx at https://margy.narez.xyz/store/api/ and serves
the uploaded pictures and apks from /store/files/. The store reads its own
newest version from /store/api/self and updates itself.
Building it yourself
sh app/build.sh
That builds a release with Gradle, shrinks it, and signs it into build/. It
expects a JDK 17 and the Android SDK; the paths are at the top of the script.
Your build is signed with your own key, so Android will not put it over the
official one: remove that first.
Licence
GPL-3.0-or-later, in LICENSE. Fork it, change it, ship it, and keep it open.
The apps in the store are their authors', each under its own licence, named on its page.