Files

T

tony d516e93323 chore: initial checkpoint - Tesla Roadtrip planner

- Proactive Grok integration (xAI API + local CLI fallback)
- Real road routing via OSRM (no more bird's-eye lines)
- Heavy structured logging for fast iteration
- Strong sanitization + geocoding + ErrorBoundary (no black screens)
- Playwright E2E tests (API diagnostic + full UI flow)
- scripts/dev.sh for one-command startup
- Clean .env.example + documentation

This is a stable checkpoint before further prompt/UI refinement.

2026-05-15 19:24:35 +01:00

2.6 KiB

Raw Blame History

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 grok CLI 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_KEY is 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

2.6 KiB Raw Blame History Unescape Escape