Home - Codeman239/TruckMate GitHub Wiki

Welcome to the TruckMate wiki!

TruckMate App Project Outline

A. Project Description

  • App Name:β€―TruckMate
  • Purpose: Connect customers with nearby independent food trucks via real-time location, live menus, and pre-ordering so users can find, order, and pick up food faster.
  • Target audience: Urban foodies, busy professionals, and food-truck operators/entrepreneurs. β€―

B. Problem Addressing

TruckMate solves the following problems:

  1. Poor visibility of truck locations β€” customers struggle to find trucks in real time.
  2. Unpredictable wait times β€” customers waste time standing in line or traveling to a closed/empty location.
  3. Inefficient manual ordering & queueing β€” vendors lose revenue and customer loyalty due to inefficient on-site ordering.
  4. Lack of digital vendor tools β€” vendors need an easy way to update menus, inventory and manage orders. β€―

C. Platform

  1. Primary: Android (min. API level 24+) β€” built with Kotlin and Jetpack Compose.
  2. Secondary: (future): iOS via a cross-platform port (Flutter or React Native) or a native iOS rewrite.

β€―

D. Front End / Back End Support

Front End

  • Android Studio + Kotlin + Jetpack Compose (UI).
  • Responsive layouts for phones and tablets.
  • Compose Navigation (Navigation Compose) for in-app routing.
  • Local persistence: Room for offline caching.

Back End

  • Authentication: Firebase Authentication (email/password, Google Sign-In).
  • Database: Cloud Firestore with real-time listeners (preferred) β€” stores truck, menu, and order data.
  • Server Logic: Cloud Functions (optional) for menu/business rules, order processing, push notifications.
  • Push Notifications: Firebase Cloud Messaging (FCM).
  • Location Services: Google Maps / Maps SDK (maps, geocoding).
  • Background Sync: WorkManager for offline β†’ online synchronization.

E. Functionality

  1. User registration/login (email, Google Sign In)
  2. Real time GPS map to locate nearby trucks
  3. Live menu with availability and prices
  4. In app ordering & digital queue management
  5. Push notifications (order status, loyalty rewards)

F. Design (Wireframes)

Home screen with map & search bar

  1. Truck details screen (menu, ratings, ETA)
  2. Order flow screens (cart β†’ payment β†’ confirmation)
  3. Profile & rewards dashboard
  4. Admin/vendor dashboard wireframe (menu management)