Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

Premium Real-time Logistics Platform connecting Google Sheets & AppSheet with a modern React Frontend. πŸš›πŸ’¨

Notifications You must be signed in to change notification settings

pongsakfms-commits/pro-parcel-tracking

Repository files navigation

🚚 Pro Parcel Tracking System (ProTrack)

Project Banner Tech Stack

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.


✨ Key Features

For Customers (Web App)

  • 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.

For Operations (Admin & Drivers)

  • 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.

πŸ› οΈ Technology Stack

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.

πŸš€ Getting Started

Prerequisites

  • Node.js (v18+)
  • Google Cloud Project (Firebase)
  • Google Workspace Account (for Sheets/AppSheet)

Installation

  1. Clone the repository

    git clone https://github.com/pongsakfms-commits/pro-parcel-tracking.git
    cd pro-parcel-tracking
  2. Install Dependencies

    npm install
  3. Configure Environment

    • Create src/firebase.js with your Firebase Config keys.
  4. Run Locally

    npm run dev

πŸ“¦ Deployment

This project is optimized for Firebase Hosting.

# Build for production
npm run build
# Deploy to live URL
firebase deploy

πŸ‘₯ Authors & Credits

  • Pongsak - Lead Developer & Architect

"Delivering excellence, one parcel at a time." πŸš›πŸ’¨

About

Premium Real-time Logistics Platform connecting Google Sheets & AppSheet with a modern React Frontend. πŸš›πŸ’¨

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

AltStyle γ«γ‚ˆγ£γ¦ε€‰ζ›γ•γ‚ŒγŸγƒšγƒΌγ‚Έ (->γ‚ͺγƒͺγ‚ΈγƒŠγƒ«) /