Skip to content

suxrobGM/logistics-app

Repository files navigation

LogisticsX

Build Status Deploy FSL-1.1-Apache-2.0

Fleet management platform for trucking companies. An AI driven dispatch agent matches loads to trucks, checks HOS compliance, plans routes, and pulls leads from load boards - every decision logged so a human can review or override it.

AI Dispatch - Sessions & Decisions

Website Live Demo

Try it

Portal URL
TMS Portal tms.logisticsx.app
Customer Portal customer.logisticsx.app

US tenant (Default Logistics):

Role Email Password
Owner owner@test.com Test12345#
Manager manager1@test.com Test12345#
Dispatcher dispatcher1@test.com Test12345#
Driver driver1@test.com Test12345#
Customer customer1@test.com Test12345#

EU tenant (EuroFreight GmbH - EUR billing, metric units, Europe/Berlin):

Role Email Password
Owner eu_owner@test.com Test12345#
Manager eu_manager@test.com Test12345#
Dispatcher eu_dispatcher1@test.com Test12345#
Driver eu_driver1@test.com Test12345#
Customer eu_customer1@test.com Test12345#

All test credentials

Who it's for

LogisticsX is built first-class for freight, vehicle transport, and intermodal drayage operations. Other fleet types (refrigerated, flatbed, tanker, etc.) are supported experimentally and may need workflow tweaks. The platform replaces the patchwork of spreadsheets, group chats, and standalone TMS/accounting tools - dispatch, driver mobile app, customer tracking, invoicing, and payroll all run from the same system, in real time. Works across both US and EU operations, with multi-tenant isolation so each company gets its own database.

Roles:

  • Dispatchers create loads, assign drivers, search load boards, and watch deliveries - or hand it off to the agent.
  • Drivers get assignments, navigate routes, capture proof of delivery, and message dispatch from the mobile app.
  • Customers track shipments, download documents, and pay invoices through the customer portal.
  • Owners see financials, driver metrics, payroll, and operational reports.

AI dispatch agent

The agent looks at fleet state, picks a truck for a load, checks HOS compliance, plans a trip, and watches load boards for revenue. Two modes:

  • Human-in-the-loop - the agent suggests assignments; a dispatcher approves them.
  • Autonomous - the agent acts on its own.

Every decision is logged with the reasoning that produced it, so dispatchers can approve, reject, or re-plan instead of staring at a black box. See AI Dispatch and MCP Server for connecting Claude Desktop, Cursor, and other AI tools to your fleet.

Features

Operations Financial Compliance Communication
AI-powered dispatching Invoicing & Stripe payments ELD / HOS (Samsara, Motive) Real-time messaging
MCP server for AI tools Stripe Connect direct payouts Safety & DVIR inspections Push notifications
Trip planning & route optimization Multi-currency billing (USD / EUR) Document management (POD, BOL) Customer self-service portal
Intermodal container tracking (ISO 6346) Payroll & timesheets Region-aware address validation Driver mobile app
Terminals & depots (UN/LOCODE) Expense tracking Role-based access control
Fleet & maintenance tracking Reports & analytics
Load board integration (DAT, Truckstop)

Complete feature list

Quick start

dotnet run --project src/Aspire/Logistics.Aspire.AppHost

Dashboard: http://localhost:7100. For manual setup, see the Local Development Guide.

Tech stack

Layer Technologies
Backend .NET 10, ASP.NET Core, EF Core, MediatR, SignalR, Duende IdentityServer
Frontend Angular 21, PrimeNG, Tailwind CSS
Mobile Kotlin Multiplatform, Compose Multiplatform
Database PostgreSQL 18
Payments Stripe, Stripe Connect
Infrastructure Docker, .NET Aspire, Nginx, GitHub Actions
Integrations Mapbox, Firebase, Samsara, Motive, DAT, Truckstop, 123Loadboard, Claude API

Architecture: DDD + CQRS with MediatR, multi-tenant with one database per company. See architecture overview.

App Port
API 7000
Identity Server 7001
Admin Portal 7002
TMS Portal 7003
Customer Portal 7004
Website 7005

Screenshots

Sessions & Decisions Agent Timeline
Sessions Timeline

Driver Mobile App

Feature graphic

More screenshots

TMS Portal

Dashboard Loads Trips
Dashboard Loads Trips
Fleet Reports Invoicing
Fleet Reports Invoices

Customer Portal

Dashboard Shipment Details
Dashboard Shipment

Driver Mobile App Screens

Trips Trip Detail Load Detail
Trips Trip Detail Load Detail

All screenshots

Documentation

Guide Description
Features Complete feature list
Getting Started Prerequisites, local setup, Docker
Architecture System design, patterns, domain model
API Reference Authentication, endpoints, webhooks
Deployment VPS setup, Docker Compose, Nginx, SSL
AI Dispatch Agentic dispatcher architecture & API
MCP Server Connect Claude Desktop, Cursor & other AI tools to your fleet
Development Backend, Angular, mobile guides

Contributing

Pull requests welcome. Fork, branch off main, open a PR. See the development guides for coding conventions.

License

Functional Source License, Version 1.1, Apache 2.0 Future License (FSL-1.1-Apache-2.0).

Free for internal use, non-commercial use, and professional services. Commercial use that competes with LogisticsX (e.g. offering it as a hosted TMS) is not permitted during the 2-year change period. The license auto-converts to Apache 2.0 on the second anniversary of each release. For earlier commercial licensing, contact the author.

Contact

Created by Sukhrob Ilyosbekov

About

AI-powered fleet management platform with an agentic dispatcher that autonomously matches loads to trucks, ensures HOS compliance, and optimizes routes. Built for trucking companies.

Topics

Resources

License

Code of conduct

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors