wealth/docs/decisions/0056-no-input-zoom-on-iphon...

1.0 KiB

0056 Stop iPhone input zoom with maximum-scale

Status: Accepted · Area: design · Date: 2026-10-09 · Decided by: user

Context

Adopted from kasra-pay's decision 0037. iOS Safari zooms into any focused field whose text is under 16px. Island TextInput and Select render 16px text, but SearchField renders 15px (text-body-compact), so search zooms on iPhones.

Decision

  • bull's root viewport sets width=device-width, initial-scale=1, maximum-scale=1.
  • bear keeps the default viewport: nginx sends only iPads and desktops there.

Alternatives

  • 16px text in SearchField: no zoom and pinch zoom kept on every browser, but changes the search field's design in both apps.

Consequences

  • iOS Safari ignores maximum-scale for pinch zoom, so iPhone users can still zoom by hand.
  • Android Chrome obeys it: Android users of bull lose pinch zoom. This fails WCAG 2.1 AA 1.4.4 (Resize text), and Lighthouse and axe flag the viewport meta.
  • Superseding this with 16px field text removes both costs.