TFI Live G2

Even Realities G2 app for live Transport for Ireland departures.

Features

Favourite stops
Nearby stops using phone geolocation
Typed stop/route search
G2 microphone voice search through a configured STT endpoint
Stop departure board for bus, Luas/tram, rail, DART, and other GTFS modes
G2 touch controls with a mirrored phone UI
Even SDK local storage with browser storage fallback

Configuration

Create .env.local when using live data:

NTA_API_KEY=your_nta_key
NTA_TRIP_UPDATES_TARGET=https://api.nationaltransport.ie/gtfsr/v2/TripUpdates?format=json
VITE_TFI_API_BASE=https://your-worker.example
VITE_TFI_STOPS_URL=https://your-host.example/stops.json
VITE_STT_API_BASE=https://your-stt.example
VITE_STT_API_KEY=optional_stt_key

For real sideloaded/packed use, deploy a small proxy for NTA requests and set VITE_TFI_API_BASE to it. The included Cloudflare Worker at worker/nta-proxy.js keeps the NTA key server-side, caches the GTFS-R feed briefly, and returns per-stop departures from /departures?stopId=...&stopCode=.... Configure Worker secrets/vars:

NTA_API_KEY=your_nta_key
NTA_TRIP_UPDATES_TARGET=https://api.nationaltransport.ie/gtfsr/v2/TripUpdates?format=json
STOPS_URL=https://your-host.example/stops.json

VITE_TFI_STOPS_URL or ${VITE_TFI_API_BASE}/stops should return either an array of stops or { "stops": [...] }. Each stop can use camelCase or GTFS-style fields:

{
  "stop_id": "822GA00345",
  "stop_code": "345",
  "stop_name": "OConnell Street",
  "stop_lat": 53.3498,
  "stop_lon": -6.2603,
  "modes": ["bus"],
  "routes": ["1", "11", "13"]
}

The NTA key is intentionally not prefixed with VITE_; Vite keeps it server-side and proxies /api/nta/trip-updates with the required subscription headers during local/tunnel development. The Vite proxy is dev-only, so production builds should use VITE_TFI_API_BASE. If live env vars are missing or calls fail, the app falls back to demo stops/departures so the G2 flow remains testable.

Build a stop index

If you have an extracted static GTFS folder containing stops.txt, routes.txt, trips.txt, and stop_times.txt, build the compact stop index:

npm run build:stops -- /path/to/extracted-gtfs public/stops.json

Then serve public/stops.json or upload it and point VITE_TFI_STOPS_URL / Worker STOPS_URL at that JSON file.

If you deploy the Worker on a custom domain instead of *.workers.dev, add that domain to app.json under permissions[0].whitelist before packing.

Run

npm install
npm run dev

Generate a sideload QR:

XDG_CONFIG_HOME=.evenhub-config npx evenhub qr --url "https://YOUR_TUNNEL_OR_HOST"

Glasses controls

Single press: select stop or refresh departures
Swipe up/down: move selection
Double press: back; from the main menu it opens the system exit dialog

Package

npm run build
npm run pack

This creates tfi-live-g2.ehpk.

2.9 KiB Raw Blame History