From 8a6ff007e50cd128a32a98dfe5f9bb93e44415b3 Mon Sep 17 00:00:00 2001 From: Matt Hills Date: Sat, 31 Oct 2026 20:20:51 -0400 Subject: [PATCH 1/5] README: point the install section at the GitHub releases --- README.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 380b506..1d32a38 100644 --- a/README.md +++ b/README.md @@ -82,7 +82,9 @@ Found a security issue? Please don't open a public issue. See [Reporting securit ## Install -Papercase isn't in an app store yet. F-Droid and Google Play releases are on the way; signed APKs will be attached to each [GitHub release](https://github.com/mattintech/papercase/releases). +Download `papercase-vX.Y.Z.apk` from the [latest release](https://github.com/mattintech/papercase/releases/latest) and open it on your phone to install. You may need to allow your browser or file manager to install apps. + +Google Play and F-Droid listings are on the way; the badges above will work once they're live. F-Droid signs its builds with its own key, so an F-Droid install can't update a GitHub or Google Play install (or the other way round). To switch, export a backup, uninstall, install the new version, and import the backup. To build it yourself: From b5dbeeb3a57b11bfb3effe9b493b08cfe19abc67 Mon Sep 17 00:00:00 2001 From: Matt Hills Date: Sat, 31 Oct 2026 20:22:01 -0400 Subject: [PATCH 2/5] README: put store badges under Install and the coffee button under Support --- README.md | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/README.md b/README.md index 1d32a38..7514356 100644 --- a/README.md +++ b/README.md @@ -16,13 +16,6 @@ Keep your passport, driver's licence, health card and other papers on your phone No accounts. No servers. No tracking. Your documents never leave your devices unless you send them. -

- Get it on Google Play - Get it on F-Droid -
- Buy Me a Coffee -

-

Locker with documents   @@ -82,9 +75,14 @@ Found a security issue? Please don't open a public issue. See [Reporting securit ## Install -Download `papercase-vX.Y.Z.apk` from the [latest release](https://github.com/mattintech/papercase/releases/latest) and open it on your phone to install. You may need to allow your browser or file manager to install apps. +

+ Get it on Google Play + Get it on F-Droid +

-Google Play and F-Droid listings are on the way; the badges above will work once they're live. F-Droid signs its builds with its own key, so an F-Droid install can't update a GitHub or Google Play install (or the other way round). To switch, export a backup, uninstall, install the new version, and import the backup. +Google Play and F-Droid listings are on the way; these badges will work once they're live. Until then, download `papercase-vX.Y.Z.apk` from the [latest release](https://github.com/mattintech/papercase/releases/latest) and open it on your phone to install. You may need to allow your browser or file manager to install apps. + +F-Droid signs its builds with its own key, so an F-Droid install can't update a GitHub or Google Play install (or the other way round). To switch, export a backup, uninstall, install the new version, and import the backup. To build it yourself: @@ -112,7 +110,9 @@ Papercase was previously called SecurePass. It's a new app ID, so data doesn't c ## Support development -Papercase is free, with no ads and no tracking, and it always will be. If it's useful to you and you'd like to help cover the costs of development, you can [buy me a coffee](https://www.buymeacoffee.com/mattintech). Thank you. +Papercase is free, with no ads and no tracking, and it always will be. If it's useful to you and you'd like to help cover the costs of development, you can buy me a coffee. Thank you. + +Buy Me a Coffee ## Contributing From d14e501b36d1b717cda44ea7acfaeeb986cc88f9 Mon Sep 17 00:00:00 2001 From: Matt Hills Date: Sat, 31 Oct 2026 20:38:42 -0400 Subject: [PATCH 3/5] Release workflow: note that a plain manual run builds nothing --- .github/workflows/release.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml index 49c7c28..9187f8f 100644 --- a/.github/workflows/release.yml +++ b/.github/workflows/release.yml @@ -5,7 +5,7 @@ name: Release # versionName = the tag without the leading "v" # versionCode = highest versionCode on any Google Play track + 1 # Run it manually (Actions > Release > Run workflow) to print the next versionCode -# from Google Play, or tick "internal test" to build the chosen branch and upload +# from Google Play (nothing is built or uploaded), or tick "internal test" to build the chosen branch and upload # it to Google Play's internal testing track (no tag, no GitHub release). on: push: From 22c8efef47e6407165b48f4733bd276b6c537fa6 Mon Sep 17 00:00:00 2001 From: Matt Hills Date: Sat, 31 Oct 2026 20:52:07 -0400 Subject: [PATCH 4/5] F-Droid recipe: match the fdroiddata submission --- fdroid/README.md | 10 ++++++++-- fdroid/com.mattintech.papercase.yml | 24 +----------------------- 2 files changed, 9 insertions(+), 25 deletions(-) diff --git a/fdroid/README.md b/fdroid/README.md index 8286066..5cb7469 100644 --- a/fdroid/README.md +++ b/fdroid/README.md @@ -4,15 +4,21 @@ F-Droid builds Papercase from source and signs it with its own key. The store li (title, descriptions, icon, screenshots, changelogs) is read from [`fastlane/metadata/android`](../fastlane/metadata/android) in this repo. +[`com.mattintech.papercase.yml`](com.mattintech.papercase.yml) is the build recipe, kept +exactly as submitted to fdroiddata. It has no comments because F-Droid's formatter +(`fdroid rewritemeta`) removes them and its pipeline fails if the file isn't formatted. +Its `prebuild` step deletes the `playImplementation` line: the play flavor's Google library +is never built, but F-Droid's scanner checks build files too. + ## First submission -1. Tag the release on `main`, for example `v1.1.1` (the release workflow does the rest on GitHub). +1. Tag the release on `main`, for example `v1.2.1` (the release workflow does the rest on GitHub). 2. Fork https://gitlab.com/fdroid/fdroiddata and add [`com.mattintech.papercase.yml`](com.mattintech.papercase.yml) as `metadata/com.mattintech.papercase.yml`. 3. Check it locally if you have `fdroidserver` installed: ```bash - fdroid readmeta && fdroid lint com.mattintech.papercase && fdroid build -v -l com.mattintech.papercase + fdroid readmeta && fdroid lint com.mattintech.papercase && fdroid rewritemeta com.mattintech.papercase && fdroid build -v -l com.mattintech.papercase ``` 4. Open a merge request to fdroiddata using the "App inclusion" template. diff --git a/fdroid/com.mattintech.papercase.yml b/fdroid/com.mattintech.papercase.yml index 0fdb16f..8017ceb 100644 --- a/fdroid/com.mattintech.papercase.yml +++ b/fdroid/com.mattintech.papercase.yml @@ -1,6 +1,5 @@ -# Build recipe for F-Droid. Submit this file to https://gitlab.com/fdroid/fdroiddata -# as metadata/com.mattintech.papercase.yml (see fdroid/README.md). Categories: + - File Encryption & Vault - Security License: GPL-3.0-only AuthorName: Matt Hills @@ -14,35 +13,14 @@ RepoType: git Repo: https://github.com/mattintech/papercase.git Builds: - - versionName: 1.1.1 - versionCode: 3 - commit: v1.1.1 - subdir: app - gradle: - - fdroid - # The play flavor's Google libraries aren't built, but F-Droid's scanner checks build files too - prebuild: sed -i -e '/playImplementation/d' build.gradle.kts - - - versionName: 1.2.0 - versionCode: 4 - commit: v1.2.0 - subdir: app - gradle: - - fdroid - # The play flavor's Google libraries aren't built, but F-Droid's scanner checks build files too - prebuild: sed -i -e '/playImplementation/d' build.gradle.kts - - versionName: 1.2.1 versionCode: 5 commit: v1.2.1 subdir: app gradle: - fdroid - # The play flavor's Google libraries aren't built, but F-Droid's scanner checks build files too prebuild: sed -i -e '/playImplementation/d' build.gradle.kts -# F-Droid reads versionName and versionCode from app/build.gradle.kts at each tag. -# Only plain vMAJOR.MINOR.PATCH tags are picked up; pre-release tags are skipped. AutoUpdateMode: Version UpdateCheckMode: Tags ^v\d+\.\d+\.\d+$ CurrentVersion: 1.2.1 From cea47e24ce287770cee5112084e142565f9e6359 Mon Sep 17 00:00:00 2001 From: Matt Hills Date: Sat, 31 Oct 2026 21:09:04 -0400 Subject: [PATCH 5/5] README: drop F-Droid mentions until the app is submitted there --- README.md | 7 ++----- 1 file changed, 2 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index 7514356..1680aeb 100644 --- a/README.md +++ b/README.md @@ -77,12 +77,9 @@ Found a security issue? Please don't open a public issue. See [Reporting securit

Get it on Google Play - Get it on F-Droid

-Google Play and F-Droid listings are on the way; these badges will work once they're live. Until then, download `papercase-vX.Y.Z.apk` from the [latest release](https://github.com/mattintech/papercase/releases/latest) and open it on your phone to install. You may need to allow your browser or file manager to install apps. - -F-Droid signs its builds with its own key, so an F-Droid install can't update a GitHub or Google Play install (or the other way round). To switch, export a backup, uninstall, install the new version, and import the backup. +The Google Play listing is on the way; the badge will work once it's live. Until then, download `papercase-vX.Y.Z.apk` from the [latest release](https://github.com/mattintech/papercase/releases/latest) and open it on your phone to install. You may need to allow your browser or file manager to install apps. To build it yourself: @@ -99,7 +96,7 @@ Requires Android 12 (API 31) or newer, and JDK 17+ to build. There are two flavors with the same app ID: -- **`fdroid`** contains no Google libraries and works on any Android 12+ device. This is the build on F-Droid and on the GitHub releases page. +- **`fdroid`** contains no Google libraries and works on any Android 12+ device. This is the build on the GitHub releases page. - **`play`** is the Google Play build. It adds one thing: a prompt suggesting an update when Google Play has a newer version (never forced). Debug builds install as a separate app, "Papercase Debug" (`com.mattintech.papercase.debug`), so they can sit next to the store version.