ProTrack is a professional-grade, real-time logistics tracking application designed to bridge the gap between traditional operations (Google Sheets) and modern customer experiences (Web App).
It features a seamless ecosystem where drivers use a No-Code App (AppSheet) to update statuses, and customers trace their packages via a Premium React Web Interface powered by Firebase.
- Real-Time Tracking: Updates instantly as data changes in the backend.
- Visual Timeline: Dynamic progress bar from "Order Received" to "Delivered".
- Live Map Integration: Visualizes absolute location coordinates using Leaflet/OpenStreetMap.
- Proof of Delivery: Securely displays delivery confirmation references (Photos).
- Premium UI: Glassmorphism design system with responsive mobile-first layout.
- Google Sheets Backend: Manage thousands of orders in a familiar spreadsheet interface.
- Driver Mobile App: Custom AppSheet application for scanning orders, capturing GPS, and uploading photos.
- Automated Sync: Google Apps Script "Bot" that pushes data to Firestore in sub-seconds.
| Component | Technology | Description |
|---|---|---|
| Frontend | React + Vite | Fast, modern web application framework. |
| Database | Cloud Firestore | Real-time NoSQL database for sub-second updates. |
| Hosting | Firebase Hosting | Secure, global CDN delivery. |
| Operations | Google Sheets | The "CMS" for order management. |
| Driver App | AppSheet | No-code mobile solution for field operations. |
| Middleware | Apps Script | Bridging Google ecosystem with Firebase. |
- Node.js (v18+)
- Google Cloud Project (Firebase)
- Google Workspace Account (for Sheets/AppSheet)
-
Clone the repository
git clone https://github.com/pongsakfms-commits/pro-parcel-tracking.git cd pro-parcel-tracking -
Install Dependencies
npm install
-
Configure Environment
- Create
src/firebase.jswith your Firebase Config keys.
- Create
-
Run Locally
npm run dev
This project is optimized for Firebase Hosting.
# Build for production npm run build # Deploy to live URL firebase deploy
- Pongsak - Lead Developer & Architect
"Delivering excellence, one parcel at a time." ππ¨