LogisticsX

June 14, 2026 · View on GitHub

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

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

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#

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#

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

# Start local infrastructure (Postgres, runs the DB migrator once)
docker compose -f deploy/docker-compose.dev.yml up -d

# Then run the backend + a frontend
dotnet run --project src/Presentation/Logistics.IdentityServer
dotnet run --project src/Presentation/Logistics.API
bun start:tms

For full setup details, 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, Docker Compose, 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

Driver Mobile App

Feature graphic

More screenshots

TMS Portal

Dashboard	Loads	Trips

Fleet	Reports	Invoicing

Customer Portal

Dashboard	Shipment Details

Driver Mobile App Screens

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