🚛 Warp Tools

Free, open-source logistics systems that replace your spreadsheets.
Issues · Systems · Quick Start · Contributing

---

Not calculators — real software. Built by Warp because logistics companies shouldn't pay $500/mo for basic operational software.

Every system works standalone with a local SQLite database. No cloud accounts, no subscriptions, no vendor lock-in. Clone it, run it, own your data.

Systems

System	What It Replaces	Status
Carrier Management	Carrier spreadsheets, expired insurance surprises, guessed performance	✅ Available
Invoice & Payment Tracker	Excel aging reports, manual follow-up, lost invoices	✅ Available
Document Vault	Email attachments, shared drives, "where's the POD?"	✅ Available
Load Board / Dispatch	Email chains, WhatsApp groups, phone calls	✅ Available
Dock / Appointment Scheduler	Phone calls, paper sign-in sheets	✅ Available
Driver & Settlement	Excel pay calculations, disputes	✅ Available
Rate Management	Emailed rate sheets, manual comparisons	✅ Available
Mini TMS	All of the above glued together	✅ Available
Customer Portal	Phone calls asking "where's my freight?"	✅ Available
Fleet Maintenance	Spreadsheet PM schedules, missed inspections, surprise breakdowns	✅ Available

Each system works standalone. Together they're a platform — systems share carriers, rates, documents, and invoices across a unified schema.

Micro-Tools

Single-page calculators and generators — no database, no login, just open and use.

Tool	What It Does
IFTA Calculator	Fuel tax reporting across jurisdictions
Detention Calculator	Detention/demurrage charge tracking
Margin Calculator	Load margin & profitability analysis
Deadhead Calculator	Empty mile cost estimation
Rate Con Generator	Rate confirmation PDF generation
Load Profitability	Per-load P&L breakdown
Settlement Calculator	Driver settlement computation
Freight Parser	Parse freight emails/documents into structured data

Quick Start

Option 1: npm (any system)

git clone https://github.com/wearewarp/warp-tools.git
cd warp-tools
npm install

# Pick any system — they all follow the same pattern:
cd apps/carrier-management   # or any app below
npm run db:migrate           # set up SQLite database (systems only)
npm run db:seed              # optional: load sample data
npm run dev                  # start dev server

Port Reference

System	Port	Command
Carrier Management	3001	cd apps/carrier-management && npm run dev
Invoice & Payment Tracker	3003	cd apps/invoice-tracker && npm run dev
Document Vault	3004	cd apps/document-vault && npm run dev
Load Board / Dispatch	3005	cd apps/load-dispatch && npm run dev
Dock / Appointment Scheduler	3006	cd apps/dock-scheduler && npm run dev
Driver & Settlement	3007	cd apps/driver-settlements && npm run dev
Rate Management	3008	cd apps/rate-management && npm run dev
Mini TMS (Shipment Management)	3009	cd apps/shipment-management && npm run dev
IFTA Calculator	3010	cd apps/ifta-calculator && npm run dev
Detention Calculator	3011	cd apps/detention-calculator && npm run dev
Margin Calculator	3012	cd apps/margin-calculator && npm run dev
Deadhead Calculator	3013	cd apps/deadhead-calculator && npm run dev
Rate Con Generator	3014	cd apps/rate-con-generator && npm run dev
Load Profitability	3015	cd apps/load-profitability && npm run dev
Settlement Calculator	3016	cd apps/settlement-calculator && npm run dev
Freight Parser	3017	cd apps/freight-parser && npm run dev
Customer Portal	3018	cd apps/customer-portal && npm run dev
Fleet Maintenance	3019	cd apps/fleet-maintenance && npm run dev

Systems (carrier-management through shipment-management) require npm run db:migrate before first run. Micro-tools (calculators) have no database — just npm run dev.

Option 2: Docker

git clone https://github.com/wearewarp/warp-tools.git
cd warp-tools

# Run any system
docker compose up carrier-management    # → http://localhost:3001
docker compose up invoice-tracker       # → http://localhost:3003
docker compose up document-vault        # → http://localhost:3004
docker compose up load-dispatch         # → http://localhost:3005
docker compose up dock-scheduler        # → http://localhost:3006
docker compose up driver-settlements    # → http://localhost:3007
docker compose up rate-management       # → http://localhost:3008
docker compose up shipment-management   # → http://localhost:3009
docker compose up customer-portal        # → http://localhost:3018
docker compose up fleet-maintenance       # → http://localhost:3019

# Run any calculator (no database needed)
docker compose up ifta-calculator       # → http://localhost:3010
docker compose up detention-calculator  # → http://localhost:3011
docker compose up margin-calculator     # → http://localhost:3012
docker compose up deadhead-calculator   # → http://localhost:3013
docker compose up rate-con-generator    # → http://localhost:3014
docker compose up load-profitability    # → http://localhost:3015
docker compose up settlement-calculator # → http://localhost:3016
docker compose up freight-parser        # → http://localhost:3017

# Or run everything at once
docker compose up -d

Screenshots

Carrier Management

Carrier List	Carrier Detail	Compliance Dashboard

Invoice & Payment Tracker

Invoice Dashboard	Invoice List

Load Dispatch

Dispatch Dashboard	Load Detail	Kanban Board

Document Vault

Dashboard	Documents

Dock Scheduler

Dashboard	Calendar Day View

Driver & Settlement

Driver Dashboard	Settlement Detail

Rate Management

Rate Dashboard	Rate Comparison

Customer Portal

Admin Dashboard	Customer Shipments	Portal Login

Fleet Maintenance

Dashboard	Vehicle Detail

Mini TMS (Shipment Management)

TMS Dashboard	Shipment Detail	Kanban Pipeline

Architecture

warp-tools/
├── apps/
│   ├── carrier-management/    # Carrier relationship management
│   ├── invoice-tracker/       # Invoice & payment tracking
│   ├── document-vault/        # Freight document management
│   ├── load-dispatch/         # Load board & dispatch
│   ├── dock-scheduler/        # Dock door appointment scheduling
│   ├── driver-settlements/    # Driver pay & settlement management
│   ├── rate-management/       # Lane rates, carrier pricing, RFQs
│   ├── shipment-management/   # Mini TMS — unified shipment lifecycle
│   ├── customer-portal/       # Customer/shipper tracking portal
│   ├── fleet-maintenance/     # Fleet maintenance & DVIR management
│   ├── ifta-calculator/       # IFTA fuel tax calculator
│   ├── detention-calculator/  # Detention & demurrage charges
│   ├── margin-calculator/     # Load margin analysis
│   ├── deadhead-calculator/   # Empty mile cost estimation
│   ├── rate-con-generator/    # Rate confirmation PDF generator
│   ├── load-profitability/    # Per-load P&L breakdown
│   ├── settlement-calculator/ # Driver settlement computation
│   └── freight-parser/        # Parse freight docs to structured data
├── packages/
│   ├── ui/                    # Shared design system (colors, tokens)
│   └── config/                # Shared Tailwind + TypeScript config
├── docker-compose.yml         # One-command self-hosting
├── ARCHITECTURE.md            # Deep dive into system design
└── CONTRIBUTING.md            # How to contribute

See ARCHITECTURE.md for a deep dive into how the monorepo works, how systems connect, and where to put code.

Tech Stack

• Next.js 16 — React framework with App Router and Server Components
• Drizzle ORM — Type-safe database access (SQLite for self-hosted, Postgres for hosted)
• Tailwind CSS — Utility-first styling with custom Warp design tokens
• Radix UI — Accessible headless UI components
• Turborepo — High-performance monorepo build system
• Zod — Runtime schema validation

Contributing

We welcome contributions! See the Contributing Guide for:

• Development setup
• Branch naming and commit conventions
• PR process
• Architecture overview
• Ideas for what to build next

Each system's README has an "Ideas & Next Steps" section with concrete features to build, tagged by difficulty (🟢 Easy, 🟡 Medium, 🔴 Hard).

Why Open Source?

Logistics runs on spreadsheets, sticky notes, and $500/mo SaaS that looks like it was built in 2008. We think the industry deserves better — and that basic operational software should be free.

Every system is MIT-licensed. Self-host it, modify it, build on it. No telemetry, no data collection, no strings attached.

License

MIT — do whatever you want with it.

---

Built with ❤️ by Warp — Modern freight, simplified.