diff --git a/README.md b/README.md index d52c7c678..e207debf7 100644 --- a/README.md +++ b/README.md @@ -1,19 +1,27 @@ +![Kotlin](https://img.shields.io/badge/Kotlin-7f52ff?style=flat-square&logo=kotlin&logoColor=white) +![Kotlin Multiplatform](https://img.shields.io/badge/Kotlin%20Multiplatform-4c8d3f?style=flat-square&logo=kotlin&logoColor=white) +![Compose Multiplatform](https://img.shields.io/badge/Jetpack%20Compose%20Multiplatform-000000?style=flat-square&logo=android&logoColor=white) +[![Mobile-Wallet CI[Master/Dev]](https://github.com/openMF/mobile-wallet/actions/workflows/master_dev_ci.yml/badge.svg?branch=dev)](https://github.com/openMF/mobile-wallet/actions/workflows/master_dev_ci.yml) + [![Join the chat at https://mifos.slack.com/](https://img.shields.io/badge/Join%20Our%20Community-Slack-blue)](https://mifos.slack.com/) + # Mobile Wallet - -Mobile Wallet is an Kotlin Multiplatform (KMP)-based framework for mobile wallets based on top of Fineract. The app follows +Mobile Wallet is a Kotlin Multiplatform (KMP)-based application for mobile wallets built on top of Fineract. The app follows clean architecture and contains a core library module -that can be used as a dependency in any other wallet based project. It is developed at MIFOS together with a global community. +that can be used as a dependency in any other wallet-based project. It is developed at MIFOS together with a global community. ## Run the Project - ![Screenshot](https://github.com/user-attachments/assets/8023c529-1215-4c4b-b212-630f0233223f) - - **Android App**: Select the `mifospay-android` run configuration and click **Run**. - **Desktop App**: Select the `mifospay-desktop` run configuration and click **Run**. - **Web App (JavaScript)**: Select the `mifospay-web-js` run configuration and click **Run**. +### Demo Credentials +- **Fineract Instance**: demo.mifos.io +- **Username**: `venus` +- **Password**: `Venus2023#` + ## KMP Status for modules @@ -61,91 +69,90 @@ that can be used as a dependency in any other wallet based project. It is develo ✔️: Successfully compiled ❌: Not functioning, requires further attention -⚠️ **Notice:** -We are fully using [Jetpack Compose](https://developer.android.com/jetpack/compose) and are now in the process of converting to support **Kotlin Multiplatform**. +The project fully utilizes [Jetpack Compose](https://developer.android.com/jetpack/compose) with complete support for **Kotlin Multiplatform**. -Contributions are welcome in the following areas: -- Development and enhancements related to Kotlin Multiplatform. -- Logical changes or improvements in existing Jetpack Compose-based features. +We invite contributions in the following areas: +- Development of new features and enhancements using Kotlin Multiplatform. +- Improvements and refinements to existing Jetpack Compose-based functionalities. We appreciate your contributions and look forward to collaborating with you! -| Development | Chat | -|--------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------| -| ![Mobile-Wallet CI[Master/Dev]](https://github.com/openMF/mobile-wallet/workflows/Mobile-Wallet%20CI%5BMaster/Dev%5D/badge.svg?branch=dev) | [![Join the chat at https://mifos.slack.com/](https://img.shields.io/badge/Join%20Our%20Community-Slack-blue)](https://mifos.slack.com/) | ## Join Us on Slack - Mifos boasts an active and vibrant contributor community, Please join us on [slack](https://join.slack.com/t/mifos/shared_invite/zt-2f4nr6tk3-ZJlHMi1lc0R19FFEHxdvng). Once you've joined the mifos slack community, please join the `#mobile-wallet` channel to engage with mobile-wallet 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. ## How to Contribute - Thank you for your interest in contributing to the Mobile Wallet project by Mifos! We welcome all contributions and encourage you to follow these guidelines to ensure a smooth and efficient collaboration process. 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 +For development purposes, always pull from the **dev** 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. -For development, always pull the **dev** branch, as all contributions and updates are pushed here. Once development is complete, changes are merged into the **master** branch, which contains stable and bug-free code. - -To know more about branch policies, click [here](https://github.com/openMF/mobile-wallet/wiki/Branch-Policy). - -### Demo credentials -Fineract Instance: demo.mifos.io +For more detailed information about the branch policies, please refer to the [Branch Policy](https://github.com/openMF/mobile-wallet/wiki/Branch-Policy). -Username: `venus` - -Password: `Venus2023#` ### Development Setup - -To learn about the development setup, please visit the following link: -[Development Setup Guide](https://github.com/openMF/mobile-wallet/wiki/Development-Setup) +Please refer to the [Development Setup Guide](https://github.com/openMF/mobile-wallet/wiki/Development-Setup) for detailed instructions on configuring the development environment. ### **Committing Your Changes** - -Once you make changes in your local repository, you need to commit them to your GitHub repository. -Don't know how to commit? Click [here](https://github.com/openMF/mobile-wallet/wiki/Committing-Your-Changes) to learn more. +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/mobile-wallet/wiki/Committing-Your-Changes) guide. ### **Making a Pull Request** - -After pushing your changes to your forked repository, you can create a pull request to propose merging your changes into the main project. -Don't know how to create a pull request? Click [here](https://github.com/openMF/mobile-wallet/wiki/Making-a-Pull-Request) to learn more. +Once your changes have been pushed to your forked repository, you can create a pull request to propose integrating your updates into the main project. +For guidance on creating a pull request, please visit the [Making a Pull Request](https://github.com/openMF/mobile-wallet/wiki/Making-a-Pull-Request) 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/mobile-wallet/wiki/Squashing-Your-Commits) guide. -To maintain a clean and organized Git history, it is recommended to squash your commits before merging. -Don't know how to squash commits? Click [here](https://github.com/openMF/mobile-wallet/wiki/Squashing-Your-Commits) to learn more. - -### **Solving Merge Conflicts** - -Sometimes, your pull request may encounter merge conflicts that need to be resolved manually. -Don't know how to resolve merge conflicts? Click [here](https://github.com/openMF/mobile-wallet/wiki/Solving-Merge-Conflicts) to learn more. +### **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/mobile-wallet/wiki/Solving-Merge-Conflicts) guide. ### Conclusion By following these contribution guidelines, you're all set to start contributing to the Mobile Wallet (Mifos Pay) project. We appreciate your efforts and look forward to your valuable contributions. Happy coding! -## Instructions to get the latest APK +## Instructions to Get the Latest APK -To get the latest apk fom the Github actions artifacts, follow these steps: +To download the latest APK from the GitHub Actions artifacts, follow these steps: -1. Navigate to the [Actions](https://github.com/openMF/mobile-wallet/actions?query=workflow%3A%22Mobile-Wallet+CI%5BMaster%2FDev%5D%22+event%3Apush) tab of this repository. -2. Click the latest workflow from the workflows list. -3. Scroll down to the **Artifacts** section and click the **mobile-wallet** hyperlink. -4. After successful download, extract the zip file to your preferred location. +### Step 1: Access the Actions Tab +- Navigate to the [Actions Tab](https://github.com/openMF/mobile-wallet/actions?query=workflow%3A%22Mobile-Wallet+CI%5BMaster%2FDev%5D%22+event%3Apush) of this repository. -## Wiki +### Step 2: Select the Latest Workflow +- Click on the most recent workflow from the workflows list. + +### Step 3: Locate the Artifacts Section +- Scroll down to the **Artifacts** section, where you will find: + - **Android APKs** + - **Linux-App** + - **MacOS-App** + - **Windows-Apps** +- Download all the available zip files. + + ![Artifacts Section](https://github.com/user-attachments/assets/ab7783ff-3834-4be2-9ce8-6342746b22a2) +### Step 4: Extract the Files +- After downloading the files, extract the zip archives to your preferred location. + +### Step 5: Install the Application +- Open the extracted files and install the application on your device. + + +## Wiki To know more about the project, visit our [Wiki](https://github.com/openMF/mobile-wallet/wiki). ## Screenshots -| OS | Image | More Images | -|:-----------------:|:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------:|:-------------------------------------------------------------------------------------------------:| -| Android | | Load More | -| iOS | | Load More | -| Windows | | Load More | -| Linux | | Load More | + +| OS | Image | More Images | +|:-----------------:|:-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------:|:-------------------------------------------------------------------------------------------------:| +| Android | | Load More | +| iOS | | Load More | +| Windows | | Load More | +| Linux | | Load More | ## Contributors