# JOURNEY — MASTER DEVELOPMENT HANDOVER
Baseline: Stage 19 (user-confirmed working Wix preview), 8 November 2026

## Objective and preservation
Private iPhone-first UK travel companion. Do not rebuild from scratch. Keep the existing Tube, Train, Bus, Coach, Ferry, Walk, Weather, Drive, Music, Packing, ChatGPT and Recovery modules working. Prioritise large text, compact headers, uncluttered controls and portrait/landscape layouts. Do not introduce Xcode, Studio or new paid services without consent.

## Deployment status
Wix preview (Stage 19 confirmed by user): https://headless-inupedhlgea-mark20650-1409.wix-site-host.com/
Wix site ID: 201c1d33-6aeb-48eb-a69d-fa9522d4e4ab
Cloudflare: user has NOT confirmed Stage 19 deployment; do not describe Cloudflare as updated. The ZIP is a static site with index.html at archive root. Existing separate Worker endpoints and credentials are not included.

## National Express Coach — stages 10–19
- Uses supplied DfT national coach TransXChange timetable ZIP dated November 2026, converted to static coach-national-data.json (offline snapshot, not a real-time feed).
- Search by From, To, date and preferred departure; selectable scheduled services populate the Coach rolling road and scheduled intermediate stops.
- Autocomplete suggestions in From/To are drawn from timetable stops. Stage 18 improves matching/ranking for Portsmouth (The Hard Interchange) and other named stops.
- Stage 14 decluttered Coach UI. Stage 15 National Express-inspired blue/white/red palette. Stage 16 user-supplied National Express symbol and wordmark on Coach heading and home tab. Stage 17 reduced home-tab wordmark size.
- Stage 19 changed National Express Route Map link to the direct map; user confirmed it works on their device.
- Schedule data do not establish ticket availability, live position, price, cancellations or delays. Coverage and service-day exceptions depend on the downloaded snapshot. Refresh data by downloading and validating a new official dataset, converting it and testing before publishing.
- Critical app files include index.html, journey-coach.js, journey-coach.css, coach-national-search.js, coach-stop-suggestions.js, coach-national-data.json and the National Express image assets.

## Safe change process
1. Save an untouched copy of this Stage 19 ZIP.
2. Modify a copy; keep all unrelated Journey modules and existing localStorage keys intact.
3. Check syntax, archive integrity, static asset references, and actual searches on iPhone.
4. Test Portsmouth → London scheduled departures, select a service and verify stop order/times; test Portsmouth and London autocomplete; test direct route-map link and branded icons.
5. Publish to Wix preview first. Update Cloudflare only after user approval.
6. When exporting a new recovery ZIP, update the manifest to include all current coach assets and documents.

## Known limitations
Static timetable snapshot; no automatic refresh, live coach tracking or ticket booking confirmation. Browser-local saved lists and settings are not included in ZIP. Separate API keys, Cloudflare Worker secrets, third-party availability and service worker/browser cache must be managed independently. External map and booking links can leave Journey.