Skip to content

qwame2/Towflow

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

10 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿš— TowFlow โ€” Smart Towing & Roadside Assistance System

Status Backend Frontend Mobile Database License


๐Ÿš€ Overview

TowFlow is a full-stack, real-time towing and dispatch platform designed to connect users in need of roadside assistance with nearby tow truck drivers efficiently and reliably.

It solves a critical real-world problem: slow and uncoordinated emergency response during vehicle breakdowns โ€” by enabling instant service requests, live tracking, and seamless communication between users, drivers, and administrators.


๐ŸŽฏ Project Highlights

  • ๐Ÿ”ฅ Real-time tracking system (Map-based)
  • ๐Ÿ“ฑ Dual mobile apps (User + Driver)
  • โš™๏ธ Full backend API with authentication
  • ๐Ÿง  Scalable architecture (monorepo structure)
  • ๐Ÿ“Š Admin-ready system design
  • ๐Ÿ” Secure authentication (JWT)

๐Ÿ“ฑ User App (Customer Experience)


๐Ÿ  Home & Request Flow


๐Ÿ”ง Service Selection


๐Ÿš— Vehicle Management


๐Ÿ“ Live Tracking


๐Ÿ‘ค Profile & Settings


๐Ÿ†˜ Support System


๐Ÿ”„ User Workflow

  1. Select issue (flat tire, fuel, etc.)
  2. System finds nearby drivers
  3. Request is sent
  4. Driver is assigned
  5. Real-time tracking begins
  6. Service completed

๐Ÿ“ฑ Driver App (In Development)


๐Ÿš— Driver Dashboard


๐Ÿ‘ค Profile


๐Ÿšš Vehicle & Docs


๐Ÿ“‹ Menu


๐Ÿ”„ Driver Workflow

  1. Go online
  2. Receive nearby requests
  3. Accept job
  4. Navigate to user
  5. Complete trip

๐Ÿงญ System Architecture

Mobile Apps (User/Driver)
        โ†“
Backend API (Node.js)
        โ†“
PostgreSQL Database
        โ†“
Realtime Updates (WebSocket Layer)
        โ†“
Admin Dashboard (React)

๐Ÿ—„๏ธ Database Design

Users

  • id, name, email, role

Drivers

  • id, user_id, status, location

Vehicles

  • id, driver_id, type

Requests

  • id, user_id, status

Trips

  • id, request_id, earnings

๐Ÿ”Œ API Overview

Base URL: http://localhost:5000/api

Auth

  • POST /auth/register
  • POST /auth/login

Requests

  • POST /requests
  • GET /requests/nearby
  • POST /requests/:id/accept

๐Ÿ› ๏ธ Tech Stack

Backend

  • Node.js, Express
  • PostgreSQL

Frontend

  • React + Tailwind

Mobile

  • React Native (Expo)

๐Ÿš€ Deployment

  • Backend โ†’ AWS / Render
  • Database โ†’ PostgreSQL
  • Mobile โ†’ Expo
  • Web โ†’ Vercel

๐Ÿ” Security

  • JWT authentication
  • Password hashing
  • Role-based access control

๐Ÿ“– Case Study

TowFlow demonstrates:

  • Real-time system design
  • Full-stack engineering
  • Mobile + backend integration
  • Scalable architecture thinking

๐Ÿ”ฎ Roadmap

  • AI-based driver allocation
  • Predictive demand analytics
  • Payment system (MoMo) โ€” UI completed, backend integration pending
  • Multi-region scaling

๐Ÿ“Œ Status

๐Ÿšง Actively under development


๐Ÿ‘จโ€๐Ÿ’ป Author

Adomako Emmanuel Full-stack Developer | Systems Builder

About

TowFlow is a smart towing and roadside assistance management system that connects users with nearby drivers, enables real-time tracking, and streamlines emergency vehicle support.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Contributors