@@ -1,7 +1,9 @@
 # AKL Live
 
-An Android app for live Auckland Transport buses and trains, built for the
-Galaxy S26. It's the phone version of
+Live Auckland buses, trains and ferries on Android, built for the Galaxy S26.
+It's the phone version of
+[AKL Live for Windows](https://github.com/intelarc/akl-live-desktop) (the same
+app, running in a WebView), and a cousin of
 [akl-departure-board](https://github.com/intelarc/akl-departure-board), the
 ESP32 desk display.
 
@@ -16,118 +18,64 @@ The app needs an Auckland Transport API key, and none is built in. Sign up at
 to the GTFS and realtime APIs, and paste your key in the app's Settings. The
 app opens on Settings until a key is set.
 
-## Buses
-
-The 27H at Aldersgate Road, Hillsborough, both directions: stop 8669 to
-Britomart and 8664 to Waikowhai. Stops and route can be changed in Settings.
-
-- **A live scene per direction.** The bus drives toward the stop as its arrival
-  counts down, and its wheels turn while it's moving. The sky follows the real
-  time of day: sunrise, the sun's arc, sunset, then stars and a crescent moon,
-  with lit windows and the Sky Tower's beacon. The weather is Auckland's real
-  weather ([Open-Meteo](https://open-meteo.com)): cloud cover greys the sky, and
-  it drizzles, rains, fogs over or flashes with thunder when Auckland does. The
-  city lane has the skyline with Rangitoto behind; the Waikowhai lane has houses,
-  pōhutukawa in flower and Maungakiekie's obelisk.
-- **The next bus in detail.** It shows the expected arrival against the
-  timetable, on time or minutes late, and a track of the stops between the bus
-  and you with the last one it passed. From its GPS it also shows how far away
-  it is in km, its speed and how full it is.
-- **What bus is coming.** The fleet number in AT's feed (`TR3884`, `NB5760`)
-  gives the operator and, where the fleet list knows it, the model: a CRRC
-  eT12 MAX, an eD12 MAX double-decker, an Enviro200... Electric buses get a ⚡,
-  and the scene draws the right bus (double-deckers, no exhaust on electrics).
-- **The next five buses** with live and scheduled times and models.
-- **A live satellite map of the whole 27H.** Both directions over real aerial
-  photos (or a street map), every bus on its way to you gliding between GPS
-  fixes and pointing where it's heading. Tap it for full screen, then tap a bus
-  to see what it is. Pull down anywhere to refresh.
-
-## Live
-
-Every bus in Auckland on one map, about a thousand at a time, coloured by
-operator and gliding between GPS fixes. Zoom in and each one shows its heading
-and route number.
-
-- **Search** by route (`27` finds the 27H, 27W and 27T), fleet number
-  (`NB5075`) or model (`eT12`), and the map frames what it found.
-- **Filters** for electric buses, double-deckers or one operator, with live counts.
-- **Tap a bus** for its route and destination, how late it's running, its
-  speed, how full it is and what model it is. Tap the model for its page.
-
-## Fleet
-
-Every bus model on the network (the CRRC eT12 MAX, Geely C13E, Enviro500 and
-the rest), sorted by how many are out right now.
-
-- **Each model has its own page:** a drawing of it (double-deckers, tri-axles,
-  electrics), specs such as length, seats, motor and top speed, a short
-  history, the fleet numbers each operator uses, and a live map of every one of
-  them on the road, with a list you can tap to find each bus.
-- Buses whose fleet numbers aren't in the list yet are grouped under **Not
-  identified yet**, with their own map.
-
-## Trains
-
-A live map of the post-CRL network, drawn after AT's official "Ngā Tereina"
-map. It has the red City Rail Link loop (Waitematā, Te Waihorotiu,
-Karanga-a-Hape, Grafton, Newmarket, Parnell), and E-W and O-W run side by side
-out west. Harbours and volcanic cones sit behind it.
-
-- **Every train, live.** Markers glide between GPS fixes, show their direction
-  of travel, and carry an orange or red dot when a train is running 2 or 5+
-  minutes late.
-- **Pinch, pan and double-tap to zoom.** All 44 station names appear as you
-  zoom in, placed so they never overlap.
-- **Tap a train** for its destination, speed, delay, how full it is and its
-  carriage number. You also get its next ten stops with expected times.
-- **Tap a station** for live departures from every platform, with line,
-  destination, delay and countdown.
-- **Line filters** (E-W, S-C, O-W) with live counts, and a network overview
-  showing how many trains on each line are running late.
-- **Diagram, Satellite or Map.** Switch from the schematic to every train at
-  its real GPS position over aerial photos or a street map.
-- Light and dark map, following the system theme. Landscape puts the map
-  beside the panel.
+## What's in it
+
+Everything the Windows app has, laid out for a phone: tabs along the bottom,
+and the map screens' panels as sheets over the map.
+
+- **Directions.** Plan any trip across Auckland by bus, train and ferry, from
+  saved places, stops or any address, leaving now, at a time or arriving by.
+  Each option shows its legs, live delays, which bus it is (model, operator,
+  fleet number) and where it is now, with turn-by-turn walking. **Remind me to
+  leave** sends a notification. The planner runs on the phone, over AT's full
+  timetable.
+- **Stops.** Search any stop, station or wharf; live departures on every route
+  with delays, stops away and the model; approaching buses on the map.
+- **Buses.** The 27H at Aldersgate Road, both ways, each with a live scene
+  under Auckland's real sky and weather; "leave in 3 min", the next buses,
+  the rest of today, a live route map and the weather ahead. Tap the bell for
+  a notification before your bus.
+- **Trains.** The whole network in AT's line colours along the real tracks,
+  every train where its GPS puts it; tap one for its next stops, or a station
+  for every platform's departures.
+- **Live.** Every bus in Auckland on one map (plus trains and ferries), with
+  search by route, fleet number or model, and Follow.
+- **Fleet.** Every bus model on the road and how many are out, each with its
+  own page and live map.
+- **Alerts.** Every current and upcoming disruption, yours first.
+- **Maps.** Satellite (Esri, or LINZ's 7.5 cm aerials with a free key) with
+  streets and 3D buildings over them, or OpenFreeMap's street map; 3D terrain.
+- **Search everything** from the Search tab: places, stops, routes, fleet
+  numbers and models.
 
 ## How it's built
 
-Kotlin + Jetpack Compose. The scenes, the train diagram and the vehicle
-markers are drawn with Compose Canvas. The real maps are
-[MapLibre](https://maplibre.org) (open source), with:
+The app is the desktop app's web pages (plain JS, no framework) in a WebView:
 
-- satellite: [Esri World Imagery](https://www.arcgis.com/home/item.html?id=10df2279f9684e4a9f6a7f08febac2a9),
-  or with a free [LINZ Basemaps](https://basemaps.linz.govt.nz) key, Toitū Te
-  Whenua LINZ's aerial photos (7.5 cm in Auckland, CC BY 4.0). Paste a key in
-  Settings.
-- streets: [OpenFreeMap](https://openfreemap.org) (OpenStreetMap data).
+- `app/src/main/assets/web/` is a copy of
+  [akl-live-desktop](https://github.com/intelarc/akl-live-desktop)'s `src/`.
+  Don't edit it here: change the desktop app, then bring it over with
 
-Transit data comes straight from the
-[AT developer API](https://dev-portal.at.govt.nz):
+      python tools/import_desktop.py [path to akl-live-desktop]
 
-| What | Endpoint |
-|---|---|
-| Stop timetable | `gtfs/v3/stops/{id}/stoptrips` |
-| Live delays, stops away | `realtime/legacy/tripupdates?tripid=` |
-| Bus and train GPS | `realtime/legacy/vehiclelocations?tripid=` / `?vehicleid=` (all trains are 59xxx) |
-| Train destination and stops | `gtfs/v3/trips/{id}` and `.../stoptimes` |
-| Station departures | stoptrips for each platform (platforms from `parent_station`) |
-| Every bus (Live, Fleet) | `realtime/legacy/vehiclelocations`, the whole feed (~80 KB gzipped) |
-| Bus operator and model | the vehicle label (`TR3884`) looked up in `app/src/main/assets/fleet.tsv` and `models.json` |
+  That also adds the phone layer from `tools/android-web/`: `mobile.css`
+  (bottom tabs, bottom sheets, one-column grids) and `android.js` (the back
+  button, notifications, keys carried over from older versions).
+- `MainActivity.kt` is the shell. It serves the pages from the APK at
+  `https://appassets.androidplatform.net/web/`, and stands in for the desktop
+  app's main process: it downloads AT's timetable (`gtfs.zip`, ~29 MB, which
+  has no CORS headers) for the journey planner, checks it every six hours and
+  keeps it for offline, and turns web notifications into Android ones.
+- Settings (your stops, keys, theme) live in the WebView's storage, like the
+  desktop app's.
 
-Train GPS fixes are snapped onto the nearest station-to-station stretch of the
-train's own line on the schematic. `tools/gen_data.py` generates the map
-geometry, the station/platform table and the 27H's stop lists into
-`app/src/main/java/nz/aryan/akllive/data/`:
+The pages poll AT only while the app is on screen, so bus alerts and "remind
+me to leave" fire while it's open.
 
-    AT_API_KEY=... python tools/gen_data.py
-
-The app polls only while it's on screen: buses every 30 s, trains every 15 s,
-and the whole network every 20 s, only while Live or Fleet is open.
-
-AT's feed reports train speeds in m/s, as GTFS-realtime specifies, but bus
-speeds in km/h. Both were checked against how far vehicles actually moved
-between fixes.
+The desktop app's shared data comes from this repo: its
+`tools/import_android.py` reads the train network and the 27H's stops
+(`app/src/main/java/nz/aryan/akllive/data/`, generated by
+`AT_API_KEY=... python tools/gen_data.py`) and the fleet list below.
 
 ### The fleet list
 
@@ -156,9 +104,6 @@ It uses these repository secrets:
   `signing/`, which is gitignored. Back it up: updates must be signed with
   the same key.
 
-The Screenshots workflow (run it by hand) drives every screen in an emulator
-with live data; pick `build` to shoot a branch instead of the latest release.
-
 Local builds need JDK 17, the Android SDK and Gradle 8.11:
 `gradle :app:assembleRelease`. Without the signing secrets, you get a
 debug-signed APK.