akashdesai93/routeiq

How akashdesai93/routeiq works

RouteIQ is a trip-planning and driving app: users choose or search for endpoints, compare traffic-aware routes with signal counts, then simulate or follow a route with live guidance and rerouting. The map presents routes and drive state; device adapters provide location, speech, and native-shell services. The README documents these capabilities, while excerpts show key route, signal-data, and map relationships. The repository also contains a reusable design kit; its internal runtime wiring is only lightly represented here.

Main entry points: App.tsx App orchestration · signalData.ts Signal data loader · useRoutes.ts Route planning · freshRoutes.ts Fresh route checks

Components 23

Trip planning

App orchestration src/App.tsx
Trip controls src/PlanPanel.tsx
Place search src/usePlaceSearch.ts
Route planning src/useRoutes.ts

Routing and driving

Route domain core src/core/geo.ts
Mapbox directions src/providers/mapbox/client.ts
Route ranking src/core/rank.ts
Fresh route checks src/drive/freshRoutes.ts
Drive simulation src/drive/simulation.ts
Live guidance src/core/live.ts
Turn guidance src/core/guidance.ts

Map and signal data

Route map src/map/MapView.tsx
Drive map features src/map/driveFeatures.ts
Signal data loader src/signalData.ts
Overpass signals src/providers/osm/client.ts
Signal tile cache src/storage/kv.ts

Device services

Device location src/device/geolocation.ts
Native shell bridge src/device/native/index.ts

Design kit

Stage runtime design/kit/stage.tsx
Action scripts design/kit/act.ts
Cursor behavior design/kit/cursor.tsx
Geometry utilities design/kit/measure.ts

Other components

Driver

Connections 24

Driver → App orchestration: plans and drives README.md
App orchestration → Trip controls: presents trip controls src/App.tsx
Trip controls → Place search: searches places
Trip controls → Route planning: requests routes
Route planning → Mapbox directions: fetches directions src/useRoutes.ts
Route planning → Signal data loader: loads signal counts src/useRoutes.ts
Route planning → Route domain core: ranks routes src/useRoutes.ts
Mapbox directions → Route domain core: parses directions src/providers/mapbox/client.ts
App orchestration → Route map: shows trip map src/App.tsx
Route map → Drive map features: builds drive features src/map/MapView.tsx
Signal data loader → Overpass signals: requests missing tiles src/signalData.ts
Signal data loader → Signal tile cache: caches tiles src/signalData.ts
Overpass signals → Signal data loader: returns signal tiles src/providers/osm/client.ts
Route map → Driver: displays routes
Fresh route checks → Mapbox directions: checks fresh routes src/drive/freshRoutes.ts
Fresh route checks → Signal data loader: counts fresh signals src/drive/freshRoutes.ts
Fresh route checks → Drive simulation: applies simulated delay src/drive/freshRoutes.ts
App orchestration → Live guidance: starts live drive
Live guidance → Turn guidance: produces turn prompts
App orchestration → Native shell bridge: configures shell services src/App.tsx
Native shell bridge → Device location: uses device location src/device/native/index.ts
Stage runtime → Action scripts: plays scripts design/kit/act.ts
Stage runtime → Cursor behavior: uses cursor behavior
Stage runtime → Geometry utilities: uses geometry

Drawn by GitDiagram on November 13, 2026 from the repository's file tree, README and source files. Read as Markdown ·