Skip to content

Repository files navigation

GETGO PH ΓÇö Cargo in ┬╖ Trucks matched

🚚 GETGO PH

A Philippine trucking backload marketplace ΓÇö cargo in, empty trucks matched.

≡ƒîÉ getgoph.com  ┬╖  ≡ƒƒó Live in production

React Vite Firebase PWA Playwright


📦 The Problem

Philippine logistics coordination is manual and fragmented ΓÇö calls, SMS, and chat apps. The result:

  • ≡ƒÜ½ Low visibility of available trucks
  • Γå⌐∩╕Å Empty return trips (the "backload" problem)
  • ≡ƒÉó Slow coordination
  • ≡ƒñ¥ Limited trust between parties

✅ The Solution

A two-way marketplace where shippers post cargo and truckers post available space ΓÇö matched through a structured, trackable workflow instead of WhatsApp roulette.

🏭 Shippers 🚛 Truckers
Post cargo requirements Post available trucks & routes
Review bids & negotiate Bid on cargo loads
Track shipments live Fill empty return trips
Sign contracts in-app Get paid via digital wallets

🛠 Capabilities

  • Open Bidding System ΓÇö flexible price negotiation
  • Trucker Wallet ΓÇö GCash, Maya, and bank transfer payouts
  • Contact Masking ΓÇö identities stay private until a contract is confirmed
  • Live Cargo Tracking ΓÇö real-time position updates
  • Rating System ΓÇö performance-based trucker badges
  • Membership Tiers ΓÇö discounts for frequent users
  • Referral System ΓÇö broker commissions for matching deals
  • Route Optimization ΓÇö surface backload opportunities
  • Digital Contracts ΓÇö sign & manage agreements in-app
  • Dark / Light Mode ΓÇö user preference UI

🏗 Tech Stack

Layer Technology
Frontend React 18 ┬╖ Vite ┬╖ Tailwind CSS ┬╖ Lucide ┬╖ Leaflet ┬╖ Agora
Backend Firebase Cloud Functions (Node.js)
Data Firestore ┬╖ Firebase Auth ┬╖ Firebase Storage
Payments GCash ┬╖ Maya ┬╖ bank transfer flows
Real-time Firestore listeners ┬╖ FCM push notifications
E2E Testing Playwright ┬╖ Firebase Emulators
Deploy Firebase Hosting (getgoph.com)

📁 Repository Layout

getgoph/
Γö£ΓöÇΓöÇ frontend/    # React + Vite app (src/views, components, services)
Γö£ΓöÇΓöÇ functions/   # Cloud Functions (src/api/*)
Γö£ΓöÇΓöÇ tests/       # E2E specs & guides (tests/README.md)
Γö£ΓöÇΓöÇ scripts/     # Smoke tests, perf budgets, sitemap, prerender
Γö£ΓöÇΓöÇ marketing/   # Landing & marketing assets
Γö£ΓöÇΓöÇ plans/       # Product & feature plans
Γö£ΓöÇΓöÇ firebase.json
ΓööΓöÇΓöÇ package.json # E2E / ops scripts

🚀 Local Development

# Terminal 1 ΓÇö start Firebase emulators
npm run emulators:start

# Terminal 2 ΓÇö start the frontend
cd frontend
npm install
npm run dev        # http://localhost:5173

Test accounts

Role Phone Password
Shipper 09171234567 password123
Trucker 09271234567 password123

🧪 Testing

npm install
npx playwright install chromium

npm run test:e2e        # full suite
npm run test:e2e:ui     # visual runner

Coverage includes auth (phone OTP), role journeys, listing creation, contract workflows, and GCash payment flows. See tests/README.md.


💰 Platform Model

  • Platform Fee: 3% of agreed price

Production deploy & verification scripts live in package.json (deploy:hosting:prod, deploy:functions:prod, deploy:rules:prod) with post-deploy smoke checks against getgoph.com.


📊 Case Study

Objective Digitize trucking coordination in one marketplace
Impact Fewer empty return trips ┬╖ more transparency ┬╖ structured transactions
Proves Marketplace design, real business logic, production deployment

GETGO PH — Connecting Filipino truckers & shippers 🇵🇭

About

Philippine trucking backload marketplace connecting shippers with cargo to truckers with available space.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages