Skip to content

Repository files navigation

Courier & Parcel Management System

A full-stack courier and parcel management platform designed to simplify parcel delivery and tracking with role-based access for Customers, Admins, and Riders.


🚀 Project Summary

This application allows customers to send parcels easily while admins manage the entire delivery process. Admins assign riders to deliveries, and riders complete deliveries and earn money which they can cash out from their wallet. Customers can track their parcels in real-time.


🧩 Key Features

  • Customer Features:

    • Send parcels with detailed information
    • Track parcel status and delivery progress in real-time
  • Admin Features:

    • Manage all users and their roles
    • Assign riders to parcel deliveries
    • View and approve rider requests to join the platform
    • Monitor all parcel deliveries and their statuses
    • View pending tasks and all activities
  • Rider Features:

    • Receive parcel assignments from admin
    • Mark parcels as delivered
    • View delivery history and earnings
    • Wallet system to accumulate earnings
    • Cash out money from wallet
  • General:

    • Secure authentication and role-based route protection
    • Responsive and user-friendly interface
    • Real-time updates on delivery and parcel status

🔧 Technology Stack

  • Frontend: React.js, Tailwind CSS, React Router, Axios
  • Backend: Node.js, Express.js, MongoDB, Firebase Authentication, JWT
  • Hosting: Firebase (Frontend), Vercel (Backend)
  • Payment: Stripe Integration for cashouts and payments

📂 Repository Links


🔗 Live Demo

https://express-delivery-9e788.web.app/


📝 How to Run Locally

  1. Clone the repositories
  2. Follow README instructions in both client and server repos for environment setup
  3. Run npm install and npm start or equivalent commands in both projects
  4. Make sure to configure Firebase and Stripe keys as per documentation

🙏 Acknowledgements

Thanks to Excel Technologies Ltd. for the opportunity to work on this assignment.


Author: Md Rakib Hossen
Email: mdrakibhossencse@gmail.com
Portfolio: https://my-portfolio-dd98e.web.app/

About

A user-friendly interface where customers can register, log in, send parcels, and track them using a tracking ID. Admins assign riders, riders update delivery status, and their earnings are managed via a wallet system. The UI is intuitive and responsive for smooth courier management.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages