https://github.com/asciencioalex/invoice-system
Invoice System is a mobile app that integrates with an M-Pesa payment API to generate and process invoices. Laravel is used for Backend and Flutter for frontend
https://github.com/asciencioalex/invoice-system
backend dart flutter frontend laravel mpesa-api mpesa-integration php
Last synced: 3 months ago
JSON representation
Invoice System is a mobile app that integrates with an M-Pesa payment API to generate and process invoices. Laravel is used for Backend and Flutter for frontend
- Host: GitHub
- URL: https://github.com/asciencioalex/invoice-system
- Owner: AsciencioAlex
- License: mit
- Created: 2024-07-09T22:15:00.000Z (almost 2 years ago)
- Default Branch: master
- Last Pushed: 2024-07-11T14:49:22.000Z (almost 2 years ago)
- Last Synced: 2025-01-21T08:11:20.768Z (over 1 year ago)
- Topics: backend, dart, flutter, frontend, laravel, mpesa-api, mpesa-integration, php
- Language: PHP
- Homepage: https://appetize.io/app/b_tzkmbaeqyzrgrysxdoqoycjyqy
- Size: 21.8 MB
- Stars: 0
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Invoice System README
# 📗 Table of Contents
- [📖 About the Project](#about-project)
- [🛠 Built With](#built-with)
- [Tech Stack](#tech-stack)
- [Key Features](#key-features)
- [💻 Getting Started](#getting-started)
- [Setup Instructions](#setup)
- [Prerequisites](#prerequisites)
- [Screenshots](#screenshots)
- [APK Download link](#apk-download)
- [Appetize showcase](#appetize-showcase)
- [👥 Authors](#authors)
- [🔭 Future Features](#future-features)
- [🤝 Contributing](#contributing)
- [⭐️ Show your support](#support)
- [🙏 Acknowledgements](#acknowledgements)
- [❓ FAQ ](#faq)
- [📝 License](#license)
**Invoice System** is a mobile app that integrates with an M-Pesa payment API to generate and process invoices.
Backend
Frontend
- **Invoice Generation**
- **M-Pesa Payment Processing**
- **Transaction History Display**
To get a local copy up and running, follow these steps.
### Prerequisites
In order to run this project, you need the following:
- Visual Studio Code IDE
- Flutter SDK
- PHP 5.6 or higher
- Composer
### Setup Instructions
#### Backend
1. Clone the repository: `git clone https://github.com/AsciencioAlex/Invoice-System.git`
2. Navigate to the project directory: `cd Invoice-System/invoice-backend`
3. Install dependencies: `composer install`
4. Create a copy of `.env.example` and rename it to `.env`: `cp .env.example .env`
5. Generate an application key: `php artisan key:generate`
6. Configure your `.env` file with the appropriate database and M-Pesa API credentials.
7. Run the migrations: `php artisan migrate`
8. Start the development server: `php artisan serve`
#### Frontend
1. Clone the repository: `git clone https://github.com/AsciencioAlex/Invoice-System.git`
2. Navigate to the project directory: `cd Invoice-System/invoice_frontend`
3. Install dependencies: `flutter pub get`
4. Run the app on an emulator or physical device: `flutter run`
👤 **Your Name**
- GitHub: [@AsciencioAlex](https://github.com/YourUsername)
- LinkedIn: [Alex Asciencio](https://linkedin.com/in/your-profile)
- [ ] Additional payment methods
- [ ] Detailed transaction reports
- [ ] Multi-currency support
Contributions, issues, and feature requests are welcome!
Feel free to check the [issues page](https://github.com/AsciencioAlex/Invoice-System/issues).
If you like this project, feel free to clone it and incorporate features that enhance your own projects.
I thank all contributors and the open-source community for their support.
- **Can I run the project without installing on the terminal?**
- Yes, you can run it directly on the browser using Flutter Web.
- **Can I build such a page from scratch and where can I learn?**
- Yes, it's possible. You can start by learning Flutter and Laravel from their official documentation.
This project is [MIT](./LICENSE) licensed.