Mifos-Mobile Android Application for MifosX

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 Kotlin.

Status

Master	Development	Chat

Screenshots

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 :

• 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 Github Workflows CI.

  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

• ui-redesign All the contributions related to redesigning of the app should be pushed to this branch. If you're making a contribution, you are supposed to make a pull request to ui-redesign. Please make sure it passes a build check on Github Workflows CI.

  This branch will be merged with the development branch once the redesign is complete.

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

Instruction to get the latest APK

To get the latest apk of master/development branch from Github Artifacts, follow these steps:

1. Go to to the Actions tab of this repository.
2. Select the latest workflow for master/development branch.
3. Click on hyperlink 'mifos-mobile' in Artifacts section.
4. Extract the downloaded file and get the apk.

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/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.

Wiki

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

Specification

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

PaymentHub Usecases

For Payment Hub usecases, check this documentation. Mifos Mobile utilises medium connector of Payment Hub.

Note

The UI design is currently being revamped. New design can be found here