README.md

AGROMOCREDIT README

📗 Table of Contents

• 📖 About the Project
  • 🛠 Built With
    • Tech Stack
    • Key Features
  • 🚀 Live Demo
• 💻 Getting Started
  • Prerequisites
  • Setup
  • Install
  • Usage
  • Run tests
  • Deployment
• 👥 Authors
• 🔭 Future Features
• 🤝 Contributing
• ⭐️ Show your support
• 🙏 Acknowledgements
• ❓ FAQ (OPTIONAL)
• 📝 License

📖 AGRICULTURAL SUPPORT APP (AGROMOCREDIT)

AGROMOCREDIT is an innovative Mobile App that empowers small-scale farmers in Uganda by leveraging the MoMo API to facilitate direct payments, cashless transactions, and access to credit services. This repository contains the code and resources that drive this transformative solution, enhancing farmers' financial inclusion and access to crucial resources within the agriculture sector.

🛠 Built With

Tech Stack

Client

• React Native

Server

• Tomact

Database

• PostgreSQL

Key Features

• [1] Authentication (Signup and Sign in)
• [2] Receive Money from buyers
• [3] Withdraw Money from the app
• [4] Transfer Money to MTN MoMo users
• [5] Get a Loan based on your credit score at 8% Interest Rate
• [6] Repay Loan before it's due
• [7] Buy farming tools from App Market Place

(back to top)

(back to top)

💻 Getting Started

To get a local copy up and running, follow these steps.

Prerequisites

In order to run this project you need:

Setup

Clone this repository to your desired folder:

  cd my-folder
  git clone https://github.com/inspecta/Agricultural-Support-App.git

Install

Install this project with:

  cd agromocredit
  npm install

Usage

To run the project, execute the following command:

  npm start

Deployment

You can create an APK using Expo (Set of tools and services built around React Native)

(back to top)

👥 Authors

👤 Author1

• GitHub: @inspecta
• Twitter: @djmulinde
• LinkedIn: Derrick Mulinde

👤 Author2

• GitHub: @JonahKayizzi
• LinkedIn: Jonathan Kayizzi

👤 Author3

• GitHub: @Balikuddembe
• LinkedIn: Emmanuel Balikuddembe

(back to top)

🔭 Future Features

• [1] Secure authentication
• [2] Going live with MTN
• [3] Encorporating more farming services

(back to top)

🤝 Contributing

Contributions, issues, and feature requests are welcome!

Feel free to check the issues page.

(back to top)

⭐️ Show your support

If you like this project, please give it a star.

(back to top)

🙏 Acknowledgments

I want to thank Matte Ismail, Joy Bakesiga, Emmanuel Balikuddembe, and Jonathan Kayizzi for all their hard work during this project development.

(back to top)

❓ FAQ (OPTIONAL)

• [1] Can I clone and use this project's source code?

  • No.

• [2] Can I contribute to this project?

  • Yes, contact me @djmulinde@gmail.com and I'll add you as a contributor to this project.

(back to top)

📝 License

This project is MIT licensed.

(back to top)