Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/openmf/mifos-mobile

Repository for the Mifos Mobile Banking App for clients
https://github.com/openmf/mifos-mobile

android-application hilt-dependency-injection jetpack-compose kotlin kotlin-flows mifosx mvvm-architecture

Last synced: 4 days ago
JSON representation

Repository for the Mifos Mobile Banking App for clients

Awesome Lists containing this project

README 

        


Mifos Mobile



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



![Kotlin](https://img.shields.io/badge/kotlin-%237F52FF.svg?style=flat-square&logo=kotlin&logoColor=white)

![Kotlin Multiplatform](https://img.shields.io/badge/Kotlin%20Multiplatform-4c8d3f?style=flat-square&logo=kotlin&logoColor=white)

![Android](https://img.shields.io/badge/Android-3DDC84?style=flat-square&logo=android&logoColor=white)



[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](http://makeapullrequest.com)

[![GitHub license](https://img.shields.io/github/license/Naereen/StrapDown.js.svg)](https://github.com/openMF/mifos-mobile/blob/development/LICENSE)

[![GitHub release](https://img.shields.io/github/release/Naereen/StrapDown.js.svg)](https://github.com/openMF/mifos-mobile/releases/)

[![GitHub issues](https://img.shields.io/github/issues/Naereen/StrapDown.js.svg)](https://github.com/openMF/mifos-mobile/issues/)



[![Workflow for master/development branches](https://github.com/openMF/mifos-mobile/actions/workflows/master_dev_ci.yml/badge.svg)](https://github.com/openMF/mifos-mobile/actions/workflows/master_dev_ci.yml)

[![Slack](https://img.shields.io/badge/Slack-4A154B?style=flat-square&logo=slack&logoColor=white)](https://join.slack.com/t/mifos/shared_invite/zt-2wvi9t82t-DuSBdqdQVOY9fsqsLjkKPA)

[![Jira](https://img.shields.io/badge/jira-%230A0FFF.svg?style=flat-square&logo=jira&logoColor=white)](https://mifosforge.jira.com/jira/software/c/projects/MM/issues/?filter=allissues&jql=project%20%3D%20%22MM%22%20ORDER%20BY%20created%20DESC)

[![Zoom](https://img.shields.io/badge/Zoom-2D8CFF?style=flat-square&logo=zoom&logoColor=white)](https://us02web.zoom.us/meeting/register/PIZxFF_3Qi2H056amyjj2Q#/registration)






> \[!Note]

> **We're moving towards to Jira for issue tracking. Please use [Jira](https://mifosforge.jira.com/jira/software/c/projects/MM/issues/?filter=allissues&jql=project%20%3D%20%22MM%22%20ORDER%20BY%20created%20DESC) for issue tracking.**

> **And Join our [slack](https://join.slack.com/t/mifos/shared_invite/zt-2wvi9t82t-DuSBdqdQVOY9fsqsLjkKPA) community channel `mifos-mobile` to discuss all things about Mifos Mobile development, and keep discussions focused and avoid cross-posting across channels.**

> **Please join our daily Mobile Stand-Up on [Zoom](https://us02web.zoom.us/meeting/register/PIZxFF_3Qi2H056amyjj2Q#/registration).**



### Demo credentials

- **Fineract Instance**: `gsoc.mifos.community`

- **Username**: `mifos`

- **Password**: `password`



### How to Contribute

Thank you for your interest in contributing to the Mifos Mobile project by Mifos! We welcome all contributions and encourage you to follow these guidelines to ensure a smooth and efficient collaboration process.

To get started, please refer to the [Contribution Guide](https://github.com/openMF/mifos-mobile/wiki/Contribution-Guide) for detailed instructions on how to contribute to the project.



### Branch Policy

For development purposes, always pull from the **development** branch, as all contributions and updates are merged into this branch. Upon completion of development, changes are subsequently merged into the **master** branch, which represents the stable and bug-free version of the code.



### Development Setup

Please refer to the  [Development Setup Guide](https://github.com/openMF/mifos-mobile/wiki/Set-up-an-environment) for detailed instructions on configuring the development environment.



### Committing Your Changes

After making changes in your local repository, you will need to commit them to your GitHub repository.

If you are unfamiliar with the process of committing changes, please refer to the [Committing Your Changes](https://github.com/openMF/mifos-mobile/wiki/Committing-Your-Changes) guide.



### Squashing Your Commits

To ensure a clean and organized Git history, contributors are encouraged to squash their commits before merging. Instructions on how to squash commits can be found in the [Squashing Your Commits](https://github.com/openMF/mifos-mobile/wiki/Squashing-Your-Commits) guide.



### Resolving Merge Conflicts

Occasionally, merge conflicts may arise when your pull request is being reviewed. These conflicts need to be resolved manually.

To learn how to resolve merge conflicts, please refer to the [Solving Merge Conflicts](https://github.com/openMF/mifos-mobile/wiki/Solving-Merge-Conflicts) guide.



### Instructions to Get the Latest APK



To download the latest APK navigate to the latest release [here](https://github.com/openMF/mifos-mobile/releases), and download the APK file from the assets section.



### Wiki

To know more about the project details and architecture guidelines, visit our [Wiki](https://github.com/openMF/mifos-mobile/wiki).



### Code of Conduct



Mifos has adopted a Code of Conduct that we expect project participants to adhere to. Please read [the full text](CODE_OF_CONDUCT.md) so that you can understand what actions will and will not be tolerated.



### Contributors



Special thanks to the incredible code contributors who continue to drive this project forward.





  mifos-mobile-contributors