tony
f63af36451
Adds the three big "options" UX wins from Direction B:
1. Route variants (Fastest / Scenic / Cheapest)
- Grok prompt now returns a top-level variants[] summary with
drive/charge/cost/distance/pros for each variant, plus a
selectedVariant indicating which one the stops reflect.
- VariantStrip renders under the top bar with selected-state
styling, tone-coloured highlight (red/green/blue) on the most
relevant stat, and 3-5 pros pills.
- Clicking a variant fires /api/chat with selectedVariant=<id> so
Grok re-plans with that variant's bias. A "switching" state
disables the strip while the request is in flight.
- The chat route accepts selectedVariant ('fast'|'scenic'|'cheap')
and the GrokHeadlessClient threads it through both the local CLI
and xAI API paths.
2. While here (food / do / see / shop / rest)
- Every Supercharger, destination-charger and hotel stop now
returns a nearby[] array with category/icon/name/detail.
- Expanded stop card has tabs (All / Food / Do / See) — tabs
auto-hide when no items in that category. Two-column grid of
named places with walk-time + rating, e.g. "M&S Foodhall · 1 min
walk · 4.3★ · sandwiches".
3. Charger swap block
- Every charging stop now returns chargerOptions[] with the
current pick + 1-3 alternatives at the same location, each with
network (Tesla/Ionity/Allego/Fastned/BP Pulse), stalls, kW,
pricePerKwh, detourMin and an optional badge (Faster/Cheaper/
More stalls/Newer).
- ChargerSwapBlock shows the current charger as a red-tinted
header row that expands to reveal alternatives with stats and a
Use button per row.
Renamed the existing AlternativeStop UI label from "alternative(s)"
to "location alternative(s)" so it's clear when the user is swapping
the stop *location* vs swapping the *charger at the same location*.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Tesla Roadtrip — Grok-Powered Planner (UK & Europe First)
Beautiful split-pane Tesla trip planner.
Left side: Natural language chat with Grok Drive (powered by the real xAI Grok API)
Right side: Interactive Leaflet map + live itinerary that updates as you talk
First Release Focus
- United Kingdom
- Europe (France, Germany, Benelux, Switzerland, Spain)
Key Features
- Real Grok intelligence via the xAI API
- Excellent Supercharger coverage awareness across the UK & Europe
- Metric units (km, Wh/km)
- Proactive route planning — just say where you want to go
- Safe, restricted tool use
Tech Stack
- Vite + React + Tailwind + Leaflet (client)
- Express + Prisma + pino (server)
- Real xAI Grok API (with local
grokCLI as optional path) - Heavy structured logging for fast debugging
Local Development
1. Install dependencies
npm install
cd client && npm install && cd ..
2. Set up environment variables
cp .env.example .env
Then edit .env and add your xAI API key:
XAI_API_KEY=xai-YourKeyHere
You can get a key from: https://console.x.ai
3. Start the development environment
You have two options:
Option A (Recommended) – Better developer experience:
./scripts/dev.sh
Option B – Using npm:
npm run dev
Both commands will start:
- Backend: http://localhost:3000 (with detailed logging)
- Frontend: http://localhost:5173
4. Open the app
Visit: http://localhost:5173
Useful Commands
| Command | Description |
|---|---|
npm run dev |
Start both frontend and backend |
./scripts/dev.sh |
Recommended way to start (better output) |
npm run dev:server |
Start only the backend |
npm run dev:client |
Start only the frontend |
Security & Philosophy
This project follows a strict security policy:
- No packages with known active critical or high vulnerabilities
react-markdown/ remark ecosystem avoided (LLM output sanitization via DOMPurify)- All AI tool use is heavily restricted
- Maximum logging so we can debug the "chat → route → stops" flow easily
Deployment Target
Will be deployed via Dokku on Hetzner with Gitea CI.
First launch target: United Kingdom & Europe.
Need Help?
- Make sure your
XAI_API_KEYis set (otherwise you'll get very basic responses) - Check the backend terminal — it has extremely detailed logs
- The app is designed so you can iterate quickly by watching the logs
Development & Iteration Workflow (Autonomous Loop)
This project is designed for fast, autonomous iteration using Playwright.
One-Command Iteration Loop
The recommended way to test and iterate is:
./scripts/iterate.sh
This script will:
- Ensure both backend and frontend are running (via
./scripts/dev.sh) - Run the fast backend diagnostic test (
smoke test) - Run the full E2E Playwright test in headed mode
- Open the Playwright HTML report
- Show the latest screenshots and video
- Print the most relevant backend log lines from the test window
After the script finishes, review the artifacts and tell me what to fix. Then just run ./scripts/iterate.sh again.
Fast Smoke Test (Backend Only)
When you only want to quickly test if Grok is responding (without waiting for the full UI flow):
./scripts/smoke.sh
This runs in ~30–90 seconds and is perfect for prompt tuning or backend debugging.
Manual Commands
| Command | Description |
|---|---|
./scripts/dev.sh |
Start both servers (recommended) |
npm run dev |
Start both servers (via npm) |
./scripts/iterate.sh |
Full autonomous test + report loop |
./scripts/smoke.sh |
Fast backend-only Grok test |
npx playwright test |
Run all Playwright tests manually |
Test Reports & Artifacts
- Playwright HTML report:
npx playwright show-report - Screenshots & videos:
test-results/ - Backend logs: Look in your terminal or
/tmp/tesla-roadtrip-backend.log(if you enabled logging to file)
Workflow Summary
- Make a code or prompt change
- Run
./scripts/iterate.sh - Review the report + screenshots + backend logs
- Tell me what to fix
- Repeat
This loop lets me drive most of the testing and debugging with minimal manual work from you.