Files

T

tony 89b24d4c34 feat: wire build/test infra, trips API, and enriched journey stops

- Add tsconfig.json (server) + client/tsconfig.{json,app.json,node.json}
  so typecheck and tsc -b actually work.
- Fix npm test to run Playwright (was running vitest on Playwright specs);
  typecheck now covers both server and client.
- Mount routes before app.listen, add error handler, mount optional
  @tonycodes/auth-express middleware when AUTH_SECRET is set.
- Add /api/trips (GET/POST/PATCH/DELETE) backed by an in-memory store
  that gracefully degrades when DATABASE_URL is unset.
- Add prisma/seed.ts skeleton and server/types/express.d.ts for req.auth.
- Rewrite Grok prompt for combo-aware planning: charge+eat,
  stay+destination-charging, eat+viewpoint, etc., with amenities,
  cuisine, priceLevel, duration, day titles and trip highlights.
- Extend Stop schema + normalization to preserve all enrichment fields.
- New StopCard component renders combo pill, description, meta row
  (charge / stop / battery / cuisine / £-level) and amenity icons;
  map popups show the same enriched detail; timeline gains day titles
  and a HIGHLIGHTS sidebar.
- Fix server TS errors (vehicle accepted as string | {name,rangeKm},
  JSON parse results typed).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

2026-05-19 10:32:53 +01:00

4.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

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.

4.6 KiB Raw Blame History Unescape Escape