Skip to content
glowcowPublic

About

Local-first Android wallet for .pkpass passes and scanned loyalty cards.

Topics

Resources

Stars

3 stars

Watchers

0 watching

Forks

Repository files navigation

stackd

Android wallet for Apple Wallet passes (.pkpass) and physical loyalty cards. Physical cards are added by scanning their barcode with the camera, from a photo, or by typing the number; passes arrive from mail, a browser or a file manager. Android 16+ only. The interface speaks ten languages: English, Belarusian, French, German, Hebrew, Italian, Polish, Russian, Serbian and Spanish.

The stack of cards An open ticket with its barcode The sheet with ways to add a card The stack in the dark theme

Contents

Features

  • Stack — cards overlap like a deck, the newest in front; scrolling leafs through them, pinned cards form a stack of their own.
  • Open in place — a tapped card unfolds its fields and barcode at full brightness, as in Apple Wallet, to share, edit or pin it.
  • Add — a .pkpass file, a live barcode scan, a barcode in a gallery image, a photo of the card as its cover, or the number typed by hand.
  • .pkpass — opens passes and .pkpasses bundles from mail, a browser or a file manager, with their colours, images and translations.
  • Search — finds a card by its name, number or note.
  • Pass updates — a tap refreshes a pass from its issuer and the phone answers in the hand; on a schedule it notifies what changed. Off by default.
  • Backup — every card and the settings in one file, encrypted with a password if you set one; also part of Android's own backup.
  • App updates — checks the releases on GitHub and installs a new version from inside the app. The weekly check is off by default.
  • Look — light, dark or system theme, two colour schemes, ten languages including right-to-left Hebrew.
  • Private — no account, no analytics; nothing touches the network until you turn on an update.

Stack

Area Choice
Language / build Kotlin 2.4, AGP 9.4 (built-in Kotlin), Gradle 9.8, JDK 25
SDK minSdk 36 (Android 16), compileSdk/targetSdk 37
UI Jetpack Compose (BOM 2026.09), Material 3, Navigation 3
Storage Room 3 with the bundled SQLite driver, DataStore
Camera CameraX 1.6 (camera-compose viewfinder, camera-mlkit-vision)
Barcodes ML Kit barcode scanning (bundled) to read, ZXing core to draw

All versions live in gradle/libs.versions.toml.

Project layout

app/src/main/kotlin/dev/glowcow/stackd/
  barcode/   formats, ZXing renderer, ML Kit mapping and still-image scan
  pkpass/    .pkpass parser (pure JVM, unit-tested), .strings parser, importer
  update/    pass refresh from the issuer and app self-update, background
             jobs, notifications
  backup/    the backup archive, its password encryption, save and restore
  data/      Room entity/DAO/database, repository, stack ordering, settings
  ui/        theme + icons, shared components, one package per screen
             (home/Wallet.kt: the deck, scrolling and the in-place open card)
app/src/test/  parser, update and backup tests

Build

The host needs only Docker: JDK, Android SDK and the Gradle distribution live in the glowcow/android-sdk image on Docker Hub (tag = <build-tools>-gradle<gradle>), so a build downloads only the app's own dependencies. Keep the tag in step with buildToolsVersion and the Gradle wrapper. The build runs as linux/amd64 (Google ships aapt2 for x86-64 Linux only). On Apple Silicon turn on Use Rosetta for x86_64/amd64 emulation in Docker Desktop and give the VM ~12 GB of memory: a warm debug build then takes ~1 min and a release (R8) build ~3.5 min, against ~35 min under QEMU.

Local build in Docker

Run Gradle in the toolchain image with the sources mounted and a persistent dependency cache:

IMAGE=glowcow/android-sdk:37.0.0-gradle9.8.0
RUN="docker run --rm --platform linux/amd64 -v $PWD:/src -v stackd-gradle:/root/.gradle/caches -v stackd-keys:/root/.android $IMAGE"

# debug APKs + unit tests
$RUN ./gradlew testDebugUnitTest assembleDebug

# lint + release APKs, unsigned; -PappVersion sets the version
$RUN ./gradlew -PappVersion=0.1.0 lintRelease assembleRelease

The APKs land in app/build/outputs/apk/<type>/, one per ABI: app-arm64-v8a-<type>.apk for phones and app-x86_64-<type>.apk for the emulator. The stackd-keys volume keeps the debug keystore, so a rebuilt debug APK installs over the previous one.

Install on a phone

Enable Developer options → Wireless debugging on the phone, then use adb from the same image (the volume keeps the adb pairing keys):

docker run --rm -it --platform linux/amd64 -v stackd-adb:/root/.android -v "$PWD/app/build/outputs/apk":/apk \
  glowcow/android-sdk:37.0.0-gradle9.8.0 sh -c 'adb pair <ip>:<pair-port> && adb connect <ip>:<port> && adb install -r /apk/debug/app-arm64-v8a-debug.apk'

Or copy the APK to the phone and open it.

The same container reads crashes (adb logcat -b crash -d) and frame stats (adb shell dumpsys gfxinfo <package>). Judge animations on a release (R8) build: debug Compose is several times slower.

Download

Signed APKs are attached to every release. Phones take stackd-<version>-arm64-v8a-release.apk; the x86_64 one is for the emulator. There is no store listing: allow your browser or file manager to install apps, then open the file.

Releases are signed with the certificate CN=Anton Sediuk, O=glowcow, SHA-256 7E:63:EC:86:6B:13:A8:23:B4:1B:4F:07:05:75:50:13:8F:B6:65:C3:50:B8:0D:41:CF:CF:B2:19:CB:98:C5:67. Check a downloaded file with apksigner verify --print-certs <file>.apk. Versions up to 0.3.2 were signed with an earlier key and have to be uninstalled before installing a newer one.

Design

Mockups and the launcher icon come from the stackd-design bundle. The default classic scheme is neutral grey — light #F1F1F1 / dark #101010 backgrounds, accent #1F6FEB; the warm scheme of the original design has #F0EEE6 / #141413 and accent #D97757. Card colours are the design's muted #D97757 #6A9BCC #788C5D #CBCADB #E3DACC #BCD1CA #141413, then a row of vivid and deep ones. UI font: Arimo, which covers every language of the app, with page titles in Cormorant Garamond; icons are Phosphor. The header and the tab bar — an island floating at the bottom — are frosted glass: the page scrolls under them and shows through, blurred. Bright colours are drawn in Display P3 on a screen that shows it.

License

GNU General Public License v3.0 or later © Anton Sediuk. A modified version you distribute has to stay open under the same licence.

As an additional permission under section 7 of the GPL, the app may be combined and distributed with Google's ML Kit barcode scanning library, which is not free software.

Arimo and Cormorant Garamond are bundled under the SIL Open Font License 1.1 — see licenses/Arimo-OFL.txt and licenses/CormorantGaramond-OFL.txt. The icons are Phosphor Icons, MIT — see licenses/Phosphor-MIT.txt.

About

Local-first Android wallet for .pkpass passes and scanned loyalty cards.

Topics

Resources

Stars

3 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages