A reference implementation of Mifos platform wallet and payment capabilities
Branch: master
Clone or download


Mobile Wallet

Mobile Wallet is an Android-based framework for mobile wallets based on top of Fineract. The app follows clean architecture and contains a core library module that can be used as a dependency in any other wallet based project. It is developed at MIFOS together with a global community.

Master Development Chat
Build Status Build Status Join the chat at https://gitter.im/openMF/mobile-wallet


How to Contribute

This is an OpenSource project and we would be happy to see new contributors. The issues should be raised via the GitHub issue tracker. For Issue tracker guidelines please click here. All fixes should be proposed via pull requests. For pull request guidelines please click here. For commit style guidelines please click here.

Branch Policy

We have the following branches :

  • dev All the contributions should be pushed to this branch. If you're making a contribution, you are supposed to make a pull request to dev. Please make sure it passes a build check on Travis.

    It is advisable to clone only the development branch using the following command:

    git clone -b <branch> <remote_repo>

    With Git 1.7.10 and later, add --single-branch to prevent fetching of all branches. Example, with development branch:

    git clone -b development --single-branch https://github.com/username/mobile-wallet.git

  • master The master branch contains all the stable and bug-free working code. The development branch once complete will be merged with this branch.

  • redesign The app is presently being redesigned. All the work done under the redesign domain should be committed to this branch.

Development Setup

Before you begin, you should have already downloaded the Android Studio SDK and set it up correctly. You can find a guide on how to do this here: Setting up Android Studio.

Building the Code

  1. Clone the repository using HTTP: git clone https://github.com/openMF/mobile-wallet.git

  2. Open Android Studio.

  3. Click on 'Open an existing Android Studio project'

  4. Browse to the directory where you cloned the mobile-wallet repo and click OK.

  5. Let Android Studio import the project.

  6. You will see an error in gradle build related to missing RblClientIdProp and RblClientSecretProp. Add RblClientIdProp and RblClientSecretProp as environment variables with any value.

  7. Sync the project again in Android studio.