Enterprise Logistics Marketplace & Fleet Management Platform
π Live App URL: https://ailogiflow.lovable.app
- π Overview
- π System Architecture
- β¨ Key Features
- π οΈ Technology Stack
- ποΈ Database Architecture
- π Getting Started
- π Security & Data Integrity
- π License
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.
- 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.
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
- 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:
- Origin & Destination: Geocoded pickup and delivery addresses.
- Cargo Specification: Weight (kg), freight category, and distance calculations.
- Scheduling & Confirmation: Instant quote estimation with real-time driver dispatch.
- Live Status Tracking: Monitor trips through
pending,accepted,in_transit, anddeliveredstages. - Digital Invoicing: Automated receipt generation (
RCPT-XXXXXXXXXX) and payment records. - Ratings & Reviews: Transparent post-trip review system ensuring service reliability.
- 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.
- 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)
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.
- Node.js 20+
- npm, pnpm, or bun
git clone https://github.com/dipzz0/LogiFlow.git
cd LogiFlownpm installCreate a .env file in the project root:
cp .env.example .envFill 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-keynpm run devOpen http://localhost:3000 in your browser to view the application.
- 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.
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. π
