Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/huss3n/mpesaappclone
This is a clone of the popular Mpesa App by Safaricom. The app is built using Swift and SwiftUI which is an iOS framework.
https://github.com/huss3n/mpesaappclone
countries-api exchange-rates firebase firebase-auth firestore mpesa-api mpesa-payments safaricom swift swiftui
Last synced: 4 days ago
JSON representation
This is a clone of the popular Mpesa App by Safaricom. The app is built using Swift and SwiftUI which is an iOS framework.
- Host: GitHub
- URL: https://github.com/huss3n/mpesaappclone
- Owner: Huss3n
- Created: 2024-05-30T07:59:46.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2024-06-20T07:50:35.000Z (5 months ago)
- Last Synced: 2024-06-20T19:43:51.457Z (5 months ago)
- Topics: countries-api, exchange-rates, firebase, firebase-auth, firestore, mpesa-api, mpesa-payments, safaricom, swift, swiftui
- Language: Swift
- Homepage:
- Size: 61 MB
- Stars: 4
- Watchers: 1
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Mpesa App Clone
## Introduction
The Mpesa App is a clone for the comprehensive mobile application for handling various financial transactions offered by Safaricom PLC.
The app simulates how users send and request money, withdraw funds, buy airtime, and manage Mshwari loans and savings.
The app also provides a secure authentication system and supports both light and dark modes.
## Features
- Send Money: Transfer funds to other users quickly and securely.
- Request Money: Send money requests to other users and update balances seamlessly.
- Withdraw: Effortlessly withdraw funds from your Mpesa account.
- Buy Airtime: Purchase airtime directly through the app.
- Mshwari Loans and Savings: Access Mshwari loans and savings accounts with real-time balance updates.
- Global Pay: Convert entered amounts using the latest exchange rates.
- Authentication: Secure authentication with phone number OTP and fallback to Mpesa PIN if biometrics fail.
- Adaptive UI: Supports both light and dark modes for a better user experience.
- Spending Tracker: Track your spending and view detailed graphs of your expenses.
## Screenshots
### Main Views
### Transaction views
### Mshwari and Global Pay views
## Usage
1. Sign Up/Login: Use your phone number to sign up or log in.
2. Navigate: Use the menu to access different functionalities like sending money, requesting money, withdrawing funds, and buying airtime.
3. Manage Transactions: Track and manage your transactions through the app.
## Installation
To run this project locally, follow these steps:
1. Clone the repository
```
git clone https://github.com/Huss3n/MpesaAppClone
cd mpesa-app
```
2. Install dependencies
```
pod install
```
3. Set up Firebase
- Create a Firebase project on the Firebase Console.
- Add your app's bundle ID to the Firebase project
- Download the GoogleService-Info.plist file from Firebase and place it in the project directory. Note that the app will crash without this file.
- Turn on the phone number Authentication and Firestore database on your google console for the storage and authentication of users.
4. Set up Exchange Rate API
- Sign up at Exchange Rate API to get your API key.
- Add your Exchange Rate API key to the project on the file named Currency fetcher there is a var named apiKey
```
let apiKey = ""
```
5. Run the app
## Technologies Used
1. Swift, SwiftUI
2. Backend: Firebase (Firestore, Authentication)
3. APIs: Exchange Rate API for currency conversion
4. Security: Apple Local Authentication framework for biometrics and Mpesa PIN fallback
## Contributing
Contributions are welcome! Please follow these steps to contribute:
- Fork the repository.
- Create a new branch.
- Make your changes.
- Submit a pull request.
## Disclaimer
This app is a clone and is very similar to the real Mpesa app by Safaricom PLC.
It is intended for educational purposes only. The functionality and user experience are designed to mimic the real app, but it is not affiliated with or endorsed by Safaricom PLC.
## Contact
For any questions or feedback, please contact me at [email protected].