Skip to content

ADR-0026: Driver app as a progressive web app in version 1.0

  • Status: Accepted
  • Date: 2026-11-12

Drivers use the product on a phone. Native apps for two platforms are two more code bases and two store release processes. The product also has no hardware of its own for telemetry: position comes from the phone of the driver or from an integration.

What does the driver install in version 1.0?

  • One front-end stack for the whole product (ADR-0007).
  • Updates without a store review.
  • The limits of the web platform on a phone must be known and accepted in advance.
  1. An installable progressive web app in version 1.0, with native apps after 1.0.
  2. Native apps from the start. Deferred when the decision was made.

Chosen option: 1.

apps/driver is a React app of its own, built with Vite and vite-plugin-pwa. It can be installed on the home screen. Only the application shell is cached on the device: no API response is stored there. When a new version is available the app asks before it activates, so a form in progress is not lost. It uses the same generated client and the same design system as the office system.

The decision came with one limit stated up front: continuous tracking with the screen off is not reliable in a web app. In version 1.0 the position comes with the app open or from an integration with an electronic logging device. Background tracking arrives with the native apps.

Today the app has sign-in, company selection and its home shell. The driver features are “Planned”, see the Roadmap.

  • Good, because the driver app shares libraries, components and the contract client with the office system.
  • Good, because a new version is offered to every driver on the next visit, with no store release.
  • Bad, because there is no location tracking in the background.
  • Bad, because the app opens without signal but shows no data there: nothing from the API is kept on the device.
  • Bad, because the native apps planned for after 1.0 will be additional clients to build and maintain on the same API.