Skip to content

sudanBridge is a modern logistics management system that streamlines shipment tracking and enhances communication among stakeholders in the transportation industry. With its user-friendly interface and robust features, SudanBridge enables efficient shipment management, real-time tracking, and insightful reporting for informed decision-making.

Notifications You must be signed in to change notification settings

MohdMuslim92/SudanBridge

Repository files navigation

SudanBridge

SudanBridge is a reliable delivery service that ensures swift and secure delivery of packages across Sudan. With a focus on efficiency and customer satisfaction, SudanBridge aims to redefine delivery standards and make sending and receiving items across the country easier than ever.

Table of Contents

Vision

SudanBridge emerges from a deep-seated desire to revolutionize Sudan's delivery system. With Sudan facing logistical challenges, including slow delivery times and unreliable services, SudanBridge envisions a future where sending and receiving packages is efficient, reliable, and hassle-free.

Personal Motivation

The motivation behind SudanBridge is deeply personal. Having experienced the frustration of unreliable delivery services firsthand, the founder embarked on a mission to create SudanBridge. This platform aims to streamline the delivery process, offering customers a service they can trust.

Technical Insights

One of the key technical challenges in developing SudanBridge was integrating Vue.js into the frontend to ensure a seamless user experience, particularly in implementing real-time package tracking. The main obstacle was synchronizing the backend data with the frontend to reflect the current status and location of the shipment accurately. By leveraging Vue.js components and Axios for API requests, we were able to establish a robust communication channel between the backend and frontend, enabling users to track their packages in real-time with ease.

Key Features

  • Fast and Reliable Service: Swift and reliable delivery of packages, ensuring timely arrival.
  • Wide Coverage Area: Extensive coverage area, reaching even remote locations across Sudan.
  • Secure Handling: Assured secure handling of packages from drop-off to delivery.
  • Transparent Tracking: Real-time package tracking for peace of mind.
  • Exceptional Customer Support: Dedicated customer support to address inquiries and concerns promptly.
  • Cost-Effective Solutions: Competitive pricing and value for money, offering affordability and savings.

Installation

To run SudanBridge locally, follow these steps:

  1. Prerequisites:

    • PHP
    • Composer
    • Node.js and npm
    • Database (e.g., MySQL, PostgreSQL, SQLite)
  2. Install Laravel:

    composer global require laravel/installer
    
  3. Clone the repository and configure it:

    git clone https://github.com/MohdMuslim92/SudanBridge
    cd SudanBridge
    composer install
    cp .env.example .env
    

make sure to update the .env file and change the DB_USERNAME and DB_PASSWORD to your database credintials

  1. Install Frontend Dependencies and Vue.js:

    npm install
    
  2. Database Setup:

  • Create a database for your project.
  • Run migrations:
    php artisan migrate
    
  1. Start Development Server:

    php artisan serve
    
  2. Compile Assets with Laravel Mix:

    npm run dev
    

Usage

Once SudanBridge is set up locally, you can:

  • run database seeder to create testing users and seed the database with the required details
    php artisan db:seed
    
  • Use the platform to send or receive packages and track deliveries.

Contributing

SudanBridge is an individual project aimed at addressing specific challenges in Sudan's delivery system. While this project was developed solo, contributions, suggestions, and feedback from the community are welcome. If you have ideas for enhancements or find any issues, please feel free to:

  • Open an issue in this repository to report bugs or propose new features.
  • Fork the repository and create a pull request with your changes for review and potential inclusion.
  • Contact the project owner through email / LinkedIn to discuss potential collaborations or improvements.

Your contributions, feedback, and ideas are valued and can potentially help improve SudanBridge for its users. Thank you for considering contributing to this project!

License

This project does not currently have a specific license as it was developed individually. Please refer to the repository policies or contact the project owner for more information on copyright and usage.

About

sudanBridge is a modern logistics management system that streamlines shipment tracking and enhances communication among stakeholders in the transportation industry. With its user-friendly interface and robust features, SudanBridge enables efficient shipment management, real-time tracking, and insightful reporting for informed decision-making.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published