Spatchy AI is an AI-native dispatch operating system built for small trucking operators, independent dispatchers, and owner-operators. It automates the entire dispatch workflow using AI agents, from load intake to driver assignment, pricing, and communication.
- AI-Powered Dispatch Agent: Multi-step reasoning LLM that manages dispatch workflows
- Automated Load Management: Create, assign, and track loads in real-time
- Intelligent Driver Assignment: Smart matching based on availability, location, and workload
- Real-time Communication: Automated broker and driver messaging
- Multi-Tenant Architecture: Isolated environments for different dispatch companies
- Role-Based Access: Admin, dispatcher, and driver dashboards
- Analytics Dashboard: Operational insights and performance metrics
- Frontend: React 18 + TypeScript + Vite
- UI Framework: Tailwind CSS + shadcn/ui components
- State Management: React Query (TanStack Query)
- Routing: React Router v6
- Backend: Supabase (Auth, Postgres, RLS, Edge Functions, Realtime)
- AI Layer: Supabase Edge Functions with Anthropic/OpenAI integration
spatchy-ai-web/
├── src/
│ ├── components/
│ │ ├── ui/ # shadcn/ui components
│ │ ├── sections/ # Landing page sections
│ │ ├── dispatch/ # Dispatch-related components
│ │ └── admin/ # Admin dashboard components
│ ├── pages/ # Route pages
│ ├── hooks/ # Custom React hooks
│ ├── context/ # React context providers
│ ├── lib/ # Utilities and configurations
│ │ ├── supabase.ts # Supabase client
│ │ └── utils.ts # Helper functions
│ ├── services/ # API and business logic (to be created)
│ └── types/ # TypeScript types (to be created)
├── supabase/ # Supabase project files (to be created)
│ ├── functions/ # Edge Functions
│ └── migrations/ # Database migrations
└── public/ # Static assets
- Node.js 18+ and npm
- Supabase account (supabase.com)
- Anthropic or OpenAI API key (for AI features)
-
Clone the repository
git clone <repository-url> cd spatchy-ai-web
-
Install dependencies
npm install
-
Set up environment variables
cp .env.example .env # Edit .env and add your Supabase credentials -
Run development server
npm run dev
-
Open your browser Navigate to
http://localhost:5173
The Supabase backend includes:
requests- Load/dispatch requestsdrivers- Driver information and statusassignments- Request-to-driver assignmentsmessages- Chat and communication logsai_sessions- AI conversation sessionstenants- Multi-tenant organizationstenant_users- User-tenant relationshipsprofiles- User profile data
ai-dispatch- Multi-agent AI dispatch orchestratorcreate-request- Create new dispatch requestsassign-driver- Assign drivers to loadsupdate-status- Update request status
Database migrations and edge function code will be created in Phase 2
Spatchy AI uses a custom theme based on blue and indigo tones:
- Primary: Blue (600, 700, 800)
- Secondary: Indigo (900)
- Accent: Sky blue highlights
- Typography: Monospace for brand, sans-serif for body
Theme configuration is in src/lib/theme.ts (to be created).
npm run build
vercel deploysupabase functions deploy ai-dispatchThis project is being built in phases:
- Phase 1: Repo initialization & branding
- Phase 2: Supabase schema & server layer
- Phase 3: Dispatch operations engine
- Phase 4: AI layer enhancement
- Phase 5: UI enhancements & dashboard
- Phase 6: Multi-tenancy scaffolding
- Phase 7: Telephony integration (scaffold)
- Phase 8: Production optimization
This is a production application for Spatchy AI. For feature requests or bug reports, please contact the development team.
Proprietary - All rights reserved.
For support, please contact: [email protected]
Built with ❤️ for dispatchers who deserve better tools.