Skip to content

gemwalletcom/wallet

Gem Wallet

iOS CI Android CI License Ask DeepWiki Gem Wallet Discord X (formerly Twitter) Follow

Gem Wallet is an open-source mobile wallet for iOS and Android. This repository is the monorepo for both apps and the shared Rust core submodule they build against.

  • ios/: SwiftUI application, packages, tests, and iOS-only submodules
  • android/: Kotlin/Compose application and Android build tooling
  • core/: shared Rust submodule used by both mobile apps

📲 iOS on the App Store

🤖 Android on Google Play

Features

  • Open source, self-custodial wallet with multi-chain support
  • Native iOS and Android apps with shared Rust-based blockchain functionality
  • Swaps, staking, WalletConnect, fiat on/off ramp, alerts, and market data

Getting Started

  1. Clone the repository with submodules:
git clone --recursive https://github.com/gemwalletcom/wallet.git
cd wallet
  1. If needed, initialize submodules later:
just setup-git

iOS

Note

iOS builds require macOS. Apple silicon is the default supported environment for Gemstone builds.

cd ios
just bootstrap
just spm-resolve
just build-for-testing

If you are using an Intel Mac, update core and run just generate-stone to build the additional x86_64 Gemstone artifacts.

Android

cd android
just bootstrap
just build-test

Add GitHub Packages credentials to android/local.properties before Android builds that need private package access:

gpr.username=<your-github-username>
gpr.token=<your-github-token>

Developer Shortcuts

The repo root exposes monorepo commands plus module access to each platform:

just build
just generate
just localize
just bump patch
just ios bootstrap
just ios build
just ios build-for-testing
just ios test-without-building
just android bootstrap
just android build
just android build-test
just android test

Platform-specific commands remain available through the ios and android just modules.

Contributing

See CONTRIBUTING.md for contribution guidelines and android/reproducible/README.md for Android release verification details.

Community

License

Gem Wallet is open-sourced software licensed under the GPL-3.0.