An Android Application built on top of the MifosX Self-Service platform for end-user customers to view/transact on the accounts and loans they hold. Data visible to customers will be a sub-set of what staff can see. This is a native Android Application written in Java with POJO classes in Kotlin.

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.

We have the following branches :

• development All the contributions should be pushed to this branch. If you're making a contribution, you are supposed to make a pull request to development. 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/mifos-mobile.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.

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.

1. Clone the repository using HTTP: git clone https://github.com/openMF/mifos-mobile.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. Build the application in your device by clicking run button.

View the wiki to see pages that provide details on the project.

See the requirements for an initial design mockup and documentation on the Fineract API.