Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/openmf/android-client
An android client for the MifosX platform
https://github.com/openmf/android-client
android-application fineract-sdk hilt integration-testing kotlin mifosx mifosx-platform mobile-banking mvvm navigation-component retrofit-2 unit-testing viewbinding
Last synced: about 3 hours ago
JSON representation
An android client for the MifosX platform
- Host: GitHub
- URL: https://github.com/openmf/android-client
- Owner: openMF
- License: mpl-2.0
- Created: 2014-04-17T02:35:44.000Z (almost 11 years ago)
- Default Branch: master
- Last Pushed: 2024-05-28T13:00:27.000Z (9 months ago)
- Last Synced: 2024-05-29T04:33:52.367Z (9 months ago)
- Topics: android-application, fineract-sdk, hilt, integration-testing, kotlin, mifosx, mifosx-platform, mobile-banking, mvvm, navigation-component, retrofit-2, unit-testing, viewbinding
- Language: Kotlin
- Homepage: https://openmf.github.io/mobileapps.github.io/
- Size: 99.7 MB
- Stars: 191
- Watchers: 19
- Forks: 569
- Open Issues: 189
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: Contributing.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Android-Client Android Application for MifosX
This Android application is built on the powerful [MifosX](https://mifosforge.jira.com/wiki/spaces/MIFOSX/overview) platform and written in Kotlin. MifosX is a comprehensive core banking platform designed for field officers to efficiently process transactions, manage client data, track center records, group details, and handle various types of accounts such as loans, savings, and recurring accounts. The application's primary goal is to streamline field operations, making them easier and more efficient.
One of the standout features of this application is its offline capability, allowing officers to connect with clients and provide financial support even in remote areas. This ensures that clients in underserved areas can still access the financial services they need.
![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)
[![License](https://img.shields.io/github/license/openMF/android-client)](https://github.com/openMF/android-client/blob/main/)
[![Release](https://img.shields.io/github/v/release/openMF/android-client)](https://github.com/openMF/android-client/releases)[![PR Checks](https://github.com/openMF/android-client/actions/workflows/pr-check-android.yml/badge.svg)](https://github.com/openMF/android-client/actions/workflows/pr-check-android.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/MIFOSAC/issues/?filter=allissues&jql=project%20%3D%20%22MM%22%20ORDER%20BY%20created%20DESC)> \[!Note]
> **We're moving towards to Jira for issue tracking. Please use [Jira](https://mifosforge.jira.com/jira/software/c/projects/MIFOSAC/issues/) for issue tracking.**
> **And Join our [slack](https://join.slack.com/t/mifos/shared_invite/zt-2wvi9t82t-DuSBdqdQVOY9fsqsLjkKPA) community channel `android-client` to discuss all things about Android Client development. Please keep discussions focused and avoid cross-posting across channels.**## 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/android-client/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/android-client/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/android-client/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/android-client/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/android-client/wiki/Solving-Merge-Conflicts) guide## 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.## Wiki
Please visit our [Wiki](https://github.com/openMF/android-client/wiki) page for a detailed overview of the project's architecture and guidelines. Explore further to gain a deeper understanding of our project.
## License
This project is licensed under the open source [MPL V2](https://github.com/openMF/android-client/blob/master/LICENSE.md).
## Contributors
Special thanks to the incredible code contributors who continue to drive this project forward.