Skip to content
Sk Niyaj Ali edited this page Dec 26, 2024 · 9 revisions

Welcome to Mifos Mobile Wiki

Welcome to the Mifos Mobile wiki. This comprehensive document outlines how to contribute effectively to improve the Self Service Android Application, from reporting issues to submitting code changes. Mifos Mobile is 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 Kotlin Multiplatform Android

PRs Welcome GitHub license GitHub release GitHub issues

Workflow for master/development branches Slack Jira

Code of Conduct

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

Note

We're moving to Jira for issue tracking. Please use Jira for issue tracking. And Join our slack channel mifos-mobile to discuss all things about Mifos Mobile development. and do not cross post your messages in multiple channels. ask your question in the appropriate channel.

Quick Navigation

Getting Started

  1. Set up an Environment
  2. Project Setup
  3. Committing Your Changes

Development Guidelines

Technical Documentation

Project Modules

project-root/ Mifos Mobile

├── buildLogic/                # Shared build configuration(Gradle)

├── core/                      # Core business logic module
│   ├── common/                # Common code shared across platforms(KMP)
│   ├── model/                 # Model classes and data structures(KMP)
│   ├── data/                  # Data models and repositories(KMP)
│   ├── network/               # Networking and API clients(KMP)
│   ├── domain/                # Domain-specific logic(KMP)
│   ├── ui/                    # UI components and screens(CMP)
│   ├── designsystem/          # App-wide design system(CMP)
│   └── datastore/             # Local data storage(KMP)

├── feature/                   # CMP Feature Specific module
│   ├── about/                 # CMP about specific module
│   ├── accounts/              # CMP account specific module
│   ├── auth/                  # CMP auth specific module
│   ├── beneficiary/           # CMP beneficary specific logic
│   ├── client-charge/         # CMP faq specific logic
│   ├── guarantor/             # CMP guarantor specific logic
│   ├── help/                  # CMP help specific logic
│   ├── home/                  # CMP home specific logic
│   ├── loan/                  # CMP loan specific logic
│   ├── location/              # CMP location specific logic
│   ├── notifiaction/          # CMP notification specific logic
│   ├── qr/                    # CMP qr specific logic
│   ├── recent-transaction/    # CMP recent-transaction specific logic
│   ├── savings/               # CMP payments specific logic
│   ├── settings/              # CMP profile specific logic
│   ├── third-party-transfer/  # CMP qr specific logic
│   ├── transfer-process/      # CMP transfer-process specific logic
│   ├── update-password/       # CMP update-password specific logic
│   └── user-profile/          # CMP user-profiel specific logic

├── androidApp/                # Android Application module
├── iosApp/                    # iOS Application module

└── shared/                    # Shared Kotlin Multiplatform code

Contributing

Thank you for being so interested 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 for detailed instructions on how to contribute to the project.

The Open Source Guides website has a collection of resources for individuals, communities, and companies who want to learn how to run and contribute to an open source project. Contributors and people new to open source alike will find the following guides especially useful:

Join Us on Slack

Mifos boasts an active and vibrant contributor community, Please join us on slack. Once you've joined the mifos slack community, please join the #mifos-mobile channel to engage with mifos-mobile development. If you encounter any difficulties joining our Slack channel, please don't hesitate to open an issue. This will allow us to assist you promptly or send you an invitation.

Slack Jira

License

This project is open-source and available under Mozilla Public License Version 2.0 (MPL-2.0).