Skip to content

josephajibodu/qwikbill

Repository files navigation

Data, Airtime, and Utility Bill Payment Web Application

This is a web application that allows users to conveniently purchase data bundles, airtime, and pay their utility bills online. It provides a user-friendly interface for managing these transactions securely and efficiently.

Features

  • Data Bundles: Users can select and purchase data bundles from a variety of options available. The application integrates with mobile network providers to ensure seamless delivery of the purchased data bundles.

  • Airtime: Users can recharge their mobile phone airtime by specifying the desired amount. The application supports multiple mobile network providers for airtime top-ups.

  • Utility Bill Payments: Users can conveniently pay their utility bills, such as electricity, water, and gas bills, through the application. It supports integration with various utility service providers to enable hassle-free bill payments.

  • User Authentication and Account Management: The application provides user authentication functionality, allowing users to create accounts, log in securely, and manage their personal information.

  • Transaction History: Users can view their transaction history, including details of purchased data bundles, airtime top-ups, and utility bill payments. This feature helps users keep track of their expenses and monitor their usage patterns.

Technologies Used

The web application is built using the following technologies:

  • Front-end: Javascript (React), TailwindCSS
  • Back-end: PHP (Laravel)
  • Database: SQLite (for development), PostgreSQL (for production)
  • Payment Integration: Integration with payment gateways such as PayPal, Stripe, or local payment providers
  • API Integration: Integration with mobile network providers and utility service providers' APIs for data bundle purchases, airtime top-ups, and utility bill payments

Getting Started

To set up and run the web application locally, follow these steps:

If you are using VS Code, make sure you have prettier extension installed for the best development experience.

  1. Clone this repository to your local machine git clone git@github.com:cremirdevio/qwikbill.git
  2. Navigate into the project folder cd qwikbill
  3. Install all dependencies npm install
  4. Run the app npm run dev

Deployment

To deploy the web application to a production environment, follow these steps:

  1. Set up a hosting environment or platform (e.g., AWS, Heroku, or a shared hosting provider).

For detailed deployment instructions, refer to the documentation of your hosting platform or deployment tool.

Contributing

Contributions to this project are welcome. To contribute, follow these steps:

  1. Fork this repository.
  2. Create a new branch for your feature or bug fix.
  3. Make your changes and test them thoroughly.
  4. Commit your changes and push them to your forked repository.
  5. Submit a pull request, describing your changes in detail.

Please ensure that your code adheres to the existing coding style and conventions used in the project. Also, make sure to include tests for any new features or bug fixes.