Skip to content
dipzz0Public

About

Logistics Vehicle Booking & Fleet Management Platform built with React 19, TanStack Start, and Supabase.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

Β 

History

9 Commits

Folders and files

Repository files navigation

LogiFlow Banner

LogiFlow

Enterprise Logistics Marketplace & Fleet Management Platform

React 19 TypeScript TanStack Start Tailwind CSS Supabase License

Live Demo

πŸ”— Live App URL: https://ailogiflow.lovable.app


πŸ“‘ Table of Contents


🚚 Overview

LogiFlow is a modern, enterprise-grade logistics marketplace and fleet management ecosystem engineered to bridge the gap between commercial freight shippers and vehicle operators. Traditional road logistics often suffers from fragmented middleman networks, unpredictable price gouging, lack of shipment visibility, and cumbersome offline paperwork. LogiFlow addresses these friction points with a unified digital platform that standardizes commercial transport across intra-city delivery and long-haul inter-state transit.

Built with TanStack Start, React 19, and a hardened Supabase PostgreSQL backend, LogiFlow operates as a high-throughput, two-sided marketplace where enterprises, small businesses, and individual shippers can seamlessly discover, price, and dispatch commercial vehicles with complete transparency.

Key Value Propositions:

  • Unified Multi-Tier Fleet Discovery: Instant access to a diverse commercial fleet ranging from 1-ton city tempos and mini-trucks for rapid hyperlocal dispatches up to 40-ton multi-axle trailers and cold-chain refrigerated vans for industrial logistics.
  • Transparent Algorithmic Fare Estimation: Eliminates arbitrary broker markups with real-time, deterministic pricing computed from standardized base fares, distance matrices, and payload capacity.
  • End-to-End Shipment Lifecycle Tracking: Granular, milestone-based status updates (Pending βž” Accepted βž” In Transit βž” Delivered) providing complete operational clarity for both shippers and transporters.
  • Dedicated Dual Operational Dashboards: Tailored user experiences with separate, permission-isolated workspaces for customers (order tracking, digital invoicing, driver ratings) and vehicle owners (fleet onboarding, document compliance, earnings analytics).
  • Automated Digital Invoicing & Audit Trails: Real-time generation of compliant digital receipts (RCPT-XXXXXXXXXX) with itemized subtotal, tax breakdown, and secure payment logs.
  • Enterprise-Grade Data Security: Enforces database-level Row Level Security (RLS) policies, ensuring commercial trip data, invoices, and fleet documents remain strictly confidential between contracting parties.

πŸ“Š System Architecture

flowchart TD
    subgraph Client ["Client Interfaces"]
        UI_Customer["Customer Portal\n(Vehicle Search & Booking)"]
        UI_Owner["Fleet Owner Portal\n(Fleet & Request Management)"]
        UI_Auth["Unified Authentication\n(OTP / Email Magic Link)"]
    end

    subgraph AppLayer ["Application Core (TanStack Start / SSR)"]
        Router["File-Based Router & Middleware"]
        State["Zustand Client Store & Cache"]
        Validation["Zod Schema & Form Controllers"]
    end

    subgraph CloudLayer ["Data & Storage Layer"]
        DB["PostgreSQL (Relational Store & Enums)"]
        RLS["Row Level Security Policies"]
        Storage["Media Storage (Vehicle Photos & Docs)"]
    end

    Client --> AppLayer
    AppLayer --> CloudLayer
    CloudLayer --> DB
    CloudLayer --> RLS
    CloudLayer --> Storage
Loading

✨ Key Features

πŸ“¦ For Shippers & Cargo Customers

  • Multi-Category Fleet Discovery: Instant search across Mini Trucks, Tempos, Pickups, Container Trucks, Heavy Trailers, and Refrigerated Vans.
  • Dynamic Capacity Filtering: Filter by tonnage, volume capacity, city of operation, and base fare.
  • Streamlined 3-Step Booking:
    1. Origin & Destination: Geocoded pickup and delivery addresses.
    2. Cargo Specification: Weight (kg), freight category, and distance calculations.
    3. Scheduling & Confirmation: Instant quote estimation with real-time driver dispatch.
  • Live Status Tracking: Monitor trips through pending, accepted, in_transit, and delivered stages.
  • Digital Invoicing: Automated receipt generation (RCPT-XXXXXXXXXX) and payment records.
  • Ratings & Reviews: Transparent post-trip review system ensuring service reliability.

πŸš› For Transporters & Fleet Owners

  • Digital Fleet Onboarding: Register vehicles with registration plates, capacity, city base, and pricing formulas.
  • Document & Photo Management: Secure upload of permits, RC books, and vehicle inspections to dedicated storage buckets.
  • Interactive Dispatch Center: Real-time incoming booking requests with one-click Accept or Reject.
  • Availability Controls: One-tap toggle for vehicle online/offline statuses.
  • Earnings & Trip Analytics: Track total trips completed, gross revenue, and customer ratings.

πŸ› οΈ Technology Stack

  • Framework: TanStack Start (SSR, File-based routing, Nitro server runtime)
  • Frontend Core: React 19, TypeScript
  • State Management: TanStack Query (React Query v5), Zustand
  • Styling & Design System: Tailwind CSS v4, Radix UI Primitives, Lucide Icons
  • Animation & Visuals: Framer Motion, Recharts
  • Forms & Validation: React Hook Form, Zod
  • Backend & Storage: Supabase (PostgreSQL, Row Level Security, Auth, Storage)

πŸ—„οΈ Database Architecture

LogiFlow is powered by a relational PostgreSQL schema secured with Row Level Security (RLS):

  • profiles: User account details, contact information, and role assignments.
  • user_roles: Role-based access control (customer, owner, admin).
  • vehicles: Fleet inventory with vehicle type, capacity, rates, and availability.
  • bookings: Trip contracts with references, timestamps, pricing, and lifecycle states.
  • payments: Transaction records with payment provider references.
  • receipts: Tax and subtotal breakdowns with unique receipt identifiers.
  • tracking: Milestone timestamp updates for in-transit shipments.
  • notifications: Real-time user notification events.
  • reviews: Customer ratings (1-5 stars) and feedback.

πŸš€ Getting Started

πŸ“‹ Prerequisites

  • Node.js 20+
  • npm, pnpm, or bun

1. πŸ“₯ Clone the Repository

git clone https://github.com/dipzz0/LogiFlow.git
cd LogiFlow

2. πŸ“¦ Install Dependencies

npm install

3. βš™οΈ Setup Environment Variables

Create a .env file in the project root:

cp .env.example .env

Fill in your credentials from your Supabase project dashboard:

VITE_SUPABASE_URL=https://your-project.supabase.co
VITE_SUPABASE_PUBLISHABLE_KEY=your-publishable-key
SUPABASE_URL=https://your-project.supabase.co
SUPABASE_PUBLISHABLE_KEY=your-publishable-key

4. πŸ’» Run the Development Server

npm run dev

Open http://localhost:3000 in your browser to view the application.


πŸ”’ Security & Data Integrity

  • Environment Decoupling: Sensitive credentials, keys, and tokens are strictly kept out of version control via .gitignore.
  • Row Level Security: Database queries are strictly gated at the database layer; customers and owners access only authorized records.
  • Isolated Storage: Document uploads and vehicle media are partitioned by user ID in storage buckets with verification policies.

πŸ“„ License

This project is licensed under the MIT License β€” feel free to use, modify, and build upon it.

Built for seamless freight mobility & logistics dispatching everywhere. 🚚

About

Logistics Vehicle Booking & Fleet Management Platform built with React 19, TanStack Start, and Supabase.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages