Loading repository data…
Loading repository data…
asadatik / repository
📦 ParcelPro — A full-stack MERN application with secure JWT authentication, role-based dashboards (Admin, Sender, Receiver), and real-time parcel tracking with status management.
A transparent discovery signal based on current public GitHub metadata.
This score does not audit code, security, maintainers, documentation quality, or suitability. Verify the repository and its current documentation before adoption.
A full-stack parcel delivery management system built to streamline parcel creation, tracking, and delivery confirmation through role-based dashboards for Admin, Sender, and Receiver. The platform ensures secure operations, controlled status transitions, and real-time visibility across the entire delivery lifecycle.
ParcelPro is a smart parcel management system featuring three roles:
All user operations are protected with JWT authentication, validated with Zod, and structured using a clean, modular architecture. '
🔗 Live Demo: Parcel Delivery Frontend
💻 Repository (Back-End): GitHub
Credentials: Sender: email: asadatik709@gmail.com password: Pa$$w0rd!
Receiver: email: reciver@gmail.com password: Pa$$w0rd!
Admin: email:admin123@gmail.com password: Pa$$w0rd!
✅ JWT-based Authentication (Access & Refresh Tokens)
✅ Role-based Access Control (Admin / Sender / Receiver)
✅ Secure Password Hashing using Bcrypt
✅ Data Validation with Zod
✅ Parcel Tracking with Status Logs
✅ Modular, Maintainable Code Architecture
✅ Axios Interceptor with withCredentials
✅ Toast Notifications (React Hot Toast)
✅ Pagination, Status Badges, and Modern UI Animations
Frontend:
React + TypeScript + TailwindCSS + ShadCN UI + RTK Query + React Hook Form + Zod + Framer Motion
Backend:
Node.js + Express + TypeScript + Mongoose + Zod + JWT + Bcrypt
Database:
MongoDB (Cloud via MongoDB Atlas)
backend/
│
├── src/
│ ├── app/
│ │ ├── modules/
│ │ │ ├── auth/
│ │ │ ├── user/
│ │ │ └── parcel/
│ │ ├── middlewares/
│ │ └── utils/
│ ├── config/
│ ├── server.ts
│ └── index.ts
│
└── package.json
frontend/
│
├── src/
│ ├── components/
│ ├── pages/
│ ├── layouts/
│ ├── redux/
│ ├── routes/
│ ├── hooks/
│ ├── utils/
│ └── main.tsx
│
└── package.json
| Role | Capabilities |
|---|---|
| Admin | View all parcels, manage users, update parcel status |
| Sender | Create parcels, view & cancel own parcels |
| Receiver | View incoming parcels, confirm deliveries |
POST /auth/login → User loginPOST /auth/refresh-token → Refresh JWTPOST /auth/logout → Logout userPOST /auth/change-password → Change passwordPATCH /user/:id → Update user infoGET /user/all-users → Get all users (Admin only)GET /user/all-receiver → Get all receiver usersPOST /parcel/create → Create a new parcelGET /parcel/all → Get all parcels (Admin)GET /parcel/my → Get sender’s parcelsGET /parcel/incoming → Get receiver’s incoming parcelsPATCH /parcel/:id/status → Update parcel status (Admin)PATCH /parcel/:id/cancel → Cancel parcel (Sender)🧠 Why This Design ✅ Zod Validation ensures both backend & frontend data integrity ✅ Modular folder structure keeps code maintainable ✅ RTK Query + Axios combo provides full control + caching ✅ ObjectId-based receiver linking ensures robust data relation
git clone https://github.com/asadatik/parcel-booking-system-frontend
cd parcel-booking-system-frontend
npm install
npm run dev # Development mode
npm run build # Compile TypeScript
npm run start # Run compiled app
🧰 Future Enhancements 📊 Admin analytics dashboard with charts
🔔 Email notifications on parcel status update
⚡ Real-time status update via WebSocket
🧪 Add test cases with Jest & Supertest
##👨💻 Author : Asadujjaman Atik Full Stack Developer | Passionate about clean code & modern web apps