Welcome to Beta Relay 2.0
Beta Relay 2.0 is an enterprise-grade, real-time relay freight dispatch and fleet management platform. It is purpose-built for logistics companies that operate multi-driver relay chains across interstate corridors — enabling a single freight shipment to be handed between multiple drivers at designated relay points, dramatically reducing driver fatigue and improving delivery speed.
🎯What is the Relay (Baton) Method?
In traditional trucking, a single driver carries freight from origin to destination. With the relay baton method, a long-distance route is divided into multiple legs — typically 100–200 km each. A different driver handles each leg. When a leg is complete, the driver arrives at a pre-arranged truck stop or depot (called a relay point), where the next driver is already waiting on standby. The freight (the "baton") is transferred in 15–25 minutes, and the new driver immediately departs. This allows 24/7 freight movement without violating hours-of-service regulations.
🗺️
Real-Road GPS Routing
All routes use Google Maps Directions API — real road geometry, no straight lines.
🔄
Live Relay Handoffs
Automated baton transfers with countdown timers and real-time status updates.
📡
60fps GPS Simulation
RequestAnimationFrame engine interpolates vehicle positions smoothly on the map.
🚦
Live Traffic Layer
Google Maps real-time traffic overlay with congestion-aware speed modelling.
📊
Full Fleet Analytics
KPIs, cost charts, driver performance, utilization and route completion reports.
🔔
Intelligent Alerts
Priority-ranked alerts for low fuel, delays, maintenance, and traffic incidents.
👤
Driver Profiles
Full driver records, license class, experience, live speed, and performance metrics.
🛠️
Maintenance Scheduler
Service calendar with colour-coded upcoming and overdue maintenance records.
🏗️Technology Stack
| Layer | Technology | Purpose |
| Mapping | Google Maps JS API v3 | Interactive map, real-road polylines, markers, traffic |
| Routing | Google Directions API + Routes API v2 | Real-road geometry, traffic-aware ETAs |
| Charts | Chart.js 4.4 | Cost trends, travel distance, utilization doughnut |
| Typography | Inter + Syne + Manrope | Tabular metrics, display headings, body text |
| Animation | requestAnimationFrame | 60fps smooth vehicle movement along road paths |
| Storage | localStorage | Driver records, settings persistence across sessions |
Quick Start Guide
Get your fleet live on the map in under 2 minutes. Follow these steps after logging into your Beta Relay account.
1️⃣Open the Routes Map
- Click Routes Map in the left sidebar. The map will initialise and automatically fetch real road routes via Google Maps for today's 4 active relay shipments.
- Watch the loading indicator — it shows which API is fetching each leg. Once loaded, 4 coloured polylines appear on the map following real highways and roads.
- Driver markers (labelled D1–D4) appear on the map at their current positions and begin moving in real time along the road paths.
2️⃣Monitor a Shipment
- Click any driver marker on the map to see a popup with name, vehicle, leg progress, current speed, and traffic level.
- Click any route polyline to open the Route Info Card showing distance, ETA, driver, stops completed, and average speed.
- The bottom stats bar shows live aggregate data: total routes, progress %, total distance, average speed, and ETA.
3️⃣Plan a New Route
- Click Plan New Route in the routes toolbar (or press Ctrl+N).
- Click anywhere on the map to pin your origin (green A marker). Click again to pin your destination (red B marker). Add optional intermediate stops.
- The system automatically computes a real road route using Google Directions API. Distance and ETA are shown instantly.
- Assign a driver and name the route, then click Save & Assign Route.
The map auto-regenerates 4 fresh relay routes every day at midnight. Routes are drawn from the interstate pool (TX, LA, MS, OK, AR) and assigned to the available driver pool automatically.
⌨️Keyboard Shortcuts
| Shortcut | Action |
| Ctrl+N | Open Route Planner |
| Ctrl+S | Save current route |
| F11 | Toggle map fullscreen (on Routes page) |
| Esc | Exit fullscreen / close menus |
Dashboard
The Dashboard is your real-time command centre. It consolidates the most important fleet metrics, live speed telemetry, cost analytics, and a mini-map — all on a single screen that updates every 4 seconds.
📌KPI Strip (Top Row)
Four large KPI cards show the headline numbers at a glance. Each card includes a trend indicator, a mini progress bar, and a sub-label with contextual detail.
| KPI Card | What It Shows | Updates |
| Total Vehicles | All registered vehicles in the fleet | On vehicle add/remove |
| Active Drivers | Drivers currently en route + available | Every 4 seconds |
| Active Routes | Relay shipments currently in progress | Every 4 seconds |
| Fleet Alerts | Unresolved alerts requiring attention | Real time |
📉Metrics Row
Four secondary metric cards track operational efficiency: Total Distance (YTD km across all routes), Fuel Cost (monthly spend), On-Time Rate (delivery punctuality %), and Fleet Utilization (active vehicles as % of total).
📊Analytics Charts
Two Chart.js charts occupy the main body of the dashboard. The Fleet Cost Breakdown stacked bar chart shows monthly fuel, service, and insurance costs over 12 months. The Total Travel Distance area chart shows monthly km driven — useful for spotting seasonal patterns and utilization trends.
⚡Live Speed Monitor
The right panel shows a live speed row for each en-route driver. Each row displays the driver name, a real-time speed bar (colour-coded by traffic level: blue = light, amber = moderate, red = heavy), and the exact speed in km/h plus metres-per-tick telemetry. Stopped drivers show their stop reason and remaining wait time.
🗺️Mini-Map
A compact Google Map at the bottom of the dashboard shows the real-time positions of all en-route drivers. Clicking a driver marker on the mini-map jumps directly to the Routes Map page and focuses that driver. The four stats below the mini-map show en-route count, average speed, average progress, and total active km.
Routes Map
The Routes Map page is the live operational core of Beta Relay 2.0. It renders all active relay routes on a Google Map using real road geometry, animates vehicle positions at 60fps, and provides full dispatch control through a menu bar and toolbar.
🔧Menu Bar
| Menu | Key Actions |
| File | New Route, Import/Export routes, Print manifest, Save to CSV |
| View | Toggle map type (Roadmap / Satellite / Hybrid / Terrain), zoom controls, fullscreen |
| Routes | Recenter map, refresh all routes, optimize routes via traffic API |
| Operations | Dispatch all drivers, recall drivers, send fleet alert, emergency stop all |
| Help | Documentation (this page), keyboard shortcuts, What's New, contact support |
🎨Route Colour Coding
● Blue — Route 1
● Red — Route 2
● Green — Route 3
● Purple — Route 4
📍Map Markers Explained
| Marker | Meaning |
| Numbered circle (D1–D16) | En-route driver. Colour matches route. Shows live speed badge. |
| Grey circle (Standby) | Driver waiting at relay point for the baton to arrive. |
| Amber circle (Transferring) | Relay handoff in progress — cargo being transferred. |
| Pin with ⏳ / ⟳ / ✓ | Relay handoff point. ⏳ = waiting, ⟳ = transfer active, ✓ = completed. |
| Lettered circle (A/B/1/2…) | Route stop markers showing origin, waypoints, and destination. |
🚦Live Traffic
The traffic layer is enabled by default and shows real-time congestion from Google Maps (green = clear, orange = moderate, red = heavy). The vehicle simulation engine uses the traffic state to modulate speed: 50–55 m/tick in light traffic, 44–49 m/tick in moderate, 40–43 m/tick in heavy traffic. This affects the displayed km/h on each driver.
📋Routes Panel & Data Table
The left panel shows 4 route cards with progress bars, distance, ETA, and live speed. The bottom panel has two tabs — Timeline (Gantt-style view of each driver's leg progress) and Table (a fully resizable data table with 20 configurable columns including dispatched time, planned vs actual distance, service times, and completion status).
The Relay (Baton) System
The relay system is the defining innovation of Beta Relay 2.0. It models the real-world practice of handing a freight load between multiple drivers at scheduled intermediate stops, enabling 24/7 continuous freight movement without violating driver rest regulations.
🏗️How a Relay Shipment is Built
- A relay route is selected from the interstate pool (e.g. Houston TX → New Orleans LA — 505 km, 4 legs).
- The route is divided into legs at real truck stops, Pilot/Flying J/Love's locations. Each leg is 100–200 km.
- One driver is assigned to each leg. The Leg 1 driver departs immediately. All other drivers travel to their relay points and wait on standby.
- When the active driver completes their leg, a relay handoff is triggered: a 15–25 minute transfer window begins. The status shows "⟳ Loading" and a countdown.
- Once the transfer completes, the next driver's vehicle marker activates and begins moving along Leg 2's real road path.
- This continues until the final driver delivers to the destination. The shipment is marked complete.
🛣️Interstate Route Pool
| Route ID | Corridor | Highway | Distance | Legs |
| R-001 | Houston TX → Dallas TX | I-45 North | 390 km | 3 |
| R-002 | Houston TX → New Orleans LA | I-10 East | 505 km | 4 |
| R-003 | San Antonio TX → Dallas TX | I-35 North | 440 km | 3 |
| R-004 | Houston TX → Jackson MS | I-10/I-20 | 610 km | 4 |
| R-005 | Dallas TX → Oklahoma City OK | I-35 North | 325 km | 3 |
| R-006 | Dallas TX → Little Rock AR | I-30 East | 500 km | 3 |
⏱️Realistic Stop Simulation
En-route drivers experience realistic random stops during their leg. Each stop has a type, duration range, and a visible countdown timer on the driver marker and popup.
| Stop Type | Duration | Frequency |
| Fuel Stop | 12–20 min | ~0.8% per tick |
| Rest Break | 10–18 min | ~0.8% per tick |
| Meal Break | 12–20 min | ~0.8% per tick |
| Delivery Stop | 5–15 min | ~0.8% per tick |
| Traffic Signal | 1–3 min | ~0.8% per tick |
| Weigh Station | 8–15 min | ~0.8% per tick |
| Traffic Delay | 3–10 min | ~0.8% per tick |
Interactive Route Planner
The Route Planner lets dispatchers create custom relay legs or one-off routes directly on the map, using real road routing from Google Maps. It supports up to 8 waypoints per route.
🖱️How to Use the Planner
- Click Plan New Route in the Routes toolbar to open the planner modal.
- Click anywhere on the map to place your origin pin (green A). The system reverse-geocodes the click to show a human-readable address.
- Click again to place your destination pin (red B). With 2+ pins, the route is computed automatically using real roads.
- Add up to 6 additional intermediate stops by clicking more points. The route recomputes each time.
- The result panel shows: total distance (km), estimated travel time, and which API was used (Directions API / Routes API v2).
- Select a driver from the dropdown, enter a route name, and click Save & Assign Route.
🔀Routing Priority Chain
The planner uses a three-tier routing priority to guarantee a real road path is always found:
- Google Maps DirectionsService (primary) — built into the Maps JS SDK. Most reliable, works with any standard API key. Returns step-by-step road geometry.
- Routes API v2 (secondary) — richer traffic data. Falls back to this if DirectionsService returns an unexpected error.
- Great-circle arc path (last resort) — a densely interpolated arc shown with a dashed line, clearly indicating it is not a real road route.
To remove a waypoint, click the × beside it in the sidebar list. The route will automatically recompute with the remaining points.
Shipments
The Shipments page provides a card-based view of every active relay shipment, with live progress tracking, cargo details, stop timelines, and quick-action buttons.
📦Shipment Card Breakdown
| Element | Description |
| Route name & corridor | The relay label (e.g. "Houston TX → Dallas TX") and state corridor |
| Status pill | ⏳ Dispatched · 🚛 En Route · ✅ Delivered |
| Progress bar | Overall shipment progress as % of total route distance |
| Stop timeline | Horizontal step diagram showing Origin → Stop 1 → … → Destination, colour-coded by completion |
| Meta strip | Distance (km), ETA (traffic-aware), Live Speed (km/h) |
| Cargo panel | Cargo type, weight, declared value, assigned driver |
| Action buttons | Track Route (jumps to map), Driver Info (opens detail panel), ETA (shows notification) |
🔄Auto-Refresh
The Shipments page auto-refreshes every 12 seconds while it is the active page. This keeps progress bars, speeds, and stop completions in sync with the live simulation without requiring a manual reload. The four stat cards at the top (En Route, Completed Today, Total Route Distance, Average Progress) update on every refresh cycle.
Click Regenerate Shipments from the File menu to generate a fresh set of 4 relay routes for today. This clears the map, resets all driver positions, and loads new real-road routes from the interstate pool.
Driver Management
The Drivers page gives you a full view of every driver in your fleet — their current status, vehicle assignment, license class, experience, and live telemetry. The onboarding flow lets you add new drivers in a structured 5-step process.
🟢Driver Status Types
🟡 En Route
🟢 Available
⚫ Offline
🟣 Standby
🟠 Transferring
👤Driver Detail Panel
Clicking any driver card opens a full-width slide-in panel on the right with five information sections: Live Status (speed, traffic level, leg progress, stop reason), Contact & Personal (phone, license, experience), License & Compliance (license class, expiry, certifications), Performance Metrics (on-time rate, km driven, efficiency score), and Recent Activity (last 5 route events).
🆕Adding a New Driver (5-Step Onboarding)
| Step | Fields |
| 1 · Personal Info | Full name, date of birth, nationality, emergency contact |
| 2 · License | License class (A/B/C/D), license number, expiry date, endorsements |
| 3 · Vehicle | Assign an available vehicle from the fleet (van/car/truck) |
| 4 · Schedule | Start date, shift pattern, home depot, preferred route corridor |
| 5 · Review | Confirm all details before finalising onboarding |
🔍Search & Filter
Use the search bar to filter drivers by name, plate, or vehicle model. The status dropdown filters by En Route / Available / Offline. The vehicle type filter shows only Van, Car, or Truck drivers. All filters combine in real time.
Vehicle Fleet
The Vehicles page shows the full registered fleet with live fuel levels, driver assignments, current status, and capacity. The fuel bar updates every 30 seconds for en-route vehicles.
🚛Vehicle Types & Capacities
| Type | Example Models | Typical Capacity |
| Van | Mercedes Sprinter, Ford Transit, Ford E-Transit 350, VW Transporter, Renault Master, Mercedes Vito | 800 kg – 1,500 kg |
| Truck | Hino Truck 195, Freightliner M2, Chevrolet Truck, Isuzu NPR 3.5t, MAN TGS 7.5t, Ford F-650 | 3,500 kg – 7,500 kg |
⛽Fuel Monitoring
Each vehicle card shows a colour-coded fuel bar. The fuel level updates every 30 seconds for en-route vehicles (consumption is simulated at ~0.3% per tick).
🔵 Above 55% — Normal
🟡 30–55% — Monitor
🔴 Below 30% — Refuel Soon
➕Adding a Vehicle
Click Add Vehicle in the Vehicles toolbar. A prompt sequence collects vehicle type, name, plate number, and year. The vehicle is immediately added to the fleet and available for assignment. In the full production release, this will include a full form with VIN, insurance details, and maintenance history upload.
Alerts & Monitoring
The Alerts page provides a centralised view of all fleet events requiring dispatcher attention. Alerts are prioritised by severity and can be filtered, acknowledged, and resolved.
🚨Alert Severity Levels
| Level | Colour | Examples | Response Time |
| Critical | ■ Red | Vehicle breakdown, emergency stop triggered, GPS signal lost | Immediate |
| Warning | ■ Amber | Low fuel (<30%), driver overdue, missed relay handoff window | < 15 min |
| Info | ■ Blue | Route regenerated, new shipment dispatched, driver checked in | Informational |
| Resolved | ■ Green | Previously active alerts that have been addressed | Archive |
⚡Auto-Generated Alerts
The system generates alerts automatically for: fuel levels below 30%, vehicles overdue for service, drivers exceeding estimated leg times by more than 20%, traffic incidents on active route corridors, and emergency stops. The badge on the Alerts nav item shows the live unresolved count.
🔔Toast Notifications
In addition to the Alerts page, time-sensitive events trigger toast notifications at the bottom-right of the screen. These appear for relay handoffs, driver stops, resume events, and system messages. Each toast auto-dismisses after 6 seconds and can be manually closed.
Reports & Analytics
The Reports page delivers fleet-wide performance analytics across cost, utilization, distance, and driver efficiency — all visualised with interactive Chart.js charts and exportable data tables.
📊Available Reports
| Report | Type | Period | Export |
| Driver Performance | Table | Current month | CSV / PDF |
| Vehicle Utilization | Doughnut chart | Current day | PNG / PDF |
| Monthly Fuel Costs | Bar chart | Last 7 months | CSV / PDF |
| Route Completion | Progress bars | Live / today | PDF |
| Fleet Cost Breakdown | Stacked bar | Last 12 months | CSV / PDF |
| Total Travel Distance | Area chart | Last 12 months | CSV / PDF |
📄Export Options
Click Export PDF in the Reports toolbar to open the browser print dialog. This captures the full reports page as a high-quality PDF. The Schedule button allows you to configure automated report delivery (weekly, monthly) by email — a feature fully enabled in the production release.
📐Data Table (Routes Page)
The data table at the bottom of the Routes page provides the most granular data in the system. It has 20 configurable columns including planned vs actual distance, planned vs actual travel time, average service time, dispatched timestamp, and destination completion counts. Columns can be shown/hidden via the Customize Columns button, and each column is individually resizable by dragging the column edge.
Settings
The Settings page lets each user personalise the platform, configure API keys, and control which real-time features are active.
⚙️Settings Sections
| Section | Options |
| Profile | Display name, role title, email, timezone |
| Map Configuration | Default map type, zoom level, auto-recenter on load, traffic layer default state |
| Notifications | Toast duration, alert sound on/off, email digest frequency |
| Simulation | Tick rate (1–10s), speed range (light/moderate/heavy traffic bands), stop frequency |
| API Keys | Google Maps API key, Routes API key override (for organisations with their own billing account) |
| Data & Privacy | Clear saved driver records, reset to defaults, export all data as JSON |
Settings are persisted to localStorage and survive page refreshes. In the production cloud deployment, settings sync across all devices logged into the same account.
Subscription Plans & Pricing
Beta Relay 2.0 is offered as a SaaS subscription. All plans include the full real-road routing engine, live GPS simulation, relay handoff system, and Google Maps integration. Plans are differentiated by fleet size, number of active routes, and support tier.
Starter
$199
per month · billed annually
- Up to 10 drivers
- Up to 2 active routes
- 1 dispatcher account
- Real-road GPS routing
- Basic alerts
- Standard support (email)
Professional ⭐
$499
per month · billed annually
- Up to 50 drivers
- Up to 8 active routes
- 5 dispatcher accounts
- Full relay baton system
- Traffic-aware routing
- Advanced analytics
- API access (REST)
- Priority support
Enterprise
Custom
contact sales for pricing
- Unlimited drivers
- Unlimited active routes
- Unlimited accounts
- White-label branding
- Custom integrations
- Dedicated infrastructure
- SLA 99.9% uptime
- 24/7 dedicated support
All plans include a
14-day free trial with no credit card required. Contact our sales team at
[email protected] to start your trial or schedule a live demo.
🔑What's Included in Every Plan
Every subscription includes: the full Beta Relay 2.0 web application, Google Maps integration (using your own API key or our shared key on Starter), real-road routing via Directions API, the relay baton dispatch system, live traffic overlay, driver and vehicle management, the interactive route planner, and all dashboard analytics.
API & Integration
Beta Relay 2.0 Professional and Enterprise plans include REST API access, allowing you to integrate fleet data with your existing TMS, ERP, or warehouse management systems.
🔌Available API Endpoints (Production)
| Endpoint | Method | Description |
/api/v1/shipments | GET | List all active and completed shipments |
/api/v1/shipments/{id} | GET | Full detail of a single shipment including leg positions |
/api/v1/drivers | GET / POST | List drivers or add a new driver record |
/api/v1/drivers/{id}/position | GET | Live GPS coordinates of a driver (lat/lng + speed) |
/api/v1/routes | GET / POST | List routes or create a new relay route |
/api/v1/alerts | GET | All unresolved fleet alerts with severity and timestamp |
/api/v1/vehicles | GET / POST | Fleet vehicle list or register a new vehicle |
/api/v1/telemetry/stream | WebSocket | Real-time telemetry stream (position, speed, status) for all drivers |
🗝️Google Maps API Key Setup
- Go to Google Cloud Console → APIs & Services → Credentials.
- Create an API key and enable: Maps JavaScript API, Directions API, Routes API, and Geocoding API.
- Restrict the key to your domain for security.
- Enter the key in Beta Relay Settings → API Keys → Google Maps API Key.
Never expose your Google Maps API key in public repositories. The key included in the Beta Relay demo is for demonstration purposes and has usage limits applied.
Support & Contact
The Beta Relay support team is available to help with onboarding, technical issues, API integration, and custom enterprise requirements.
📧Contact Channels
| Channel | Contact | Response Time | Plans |
| Email Support | [email protected] | 24–48 hours | All plans |
| Priority Email | [email protected] | 4–8 hours | Professional + |
| Sales & Demo | [email protected] | Same business day | All plans |
| Enterprise Hotline | +1 (555) 000-0100 | 24/7 | Enterprise only |
| In-App Feedback | Help → Send Feedback | Logged immediately | All plans |
🆕What's New in Version 2.1
✓ Real-road DirectionsService routing (primary)
✓ Inter tabular-nums font for all metrics
✓ Routes API v2 fallback chain
✓ In-app documentation modal
✓ Responsive clamp() metric sizing
✓ Planner result markers on route draw
Beta Relay 2.0 · v2.1.0 · © 2026 Beta Relay Corp · All rights reserved
Powered by Google Maps Platform · Built for the modern relay freight industry