ios-safari-surfaces

Installation
SKILL.md

iOS Safari surfaces

Safari on iPhone does two things no desktop engine or emulator reproduces: it paints its own bars from your page, and it scrolls the screen in a different process from the one your script runs in. Both fail silently — the build is green, the desktop render is right, and the phone shows the wrong colour or a page that will not move.

Each claim is labelled: [source] read in WebKit source at the commit in Sources; [secondary] reported by others; [observed] reproduced in the iOS Simulator and on a device, mechanism not traced in source.

When to use

  • A full-bleed first screen, cover, fixed header or fixed footer ships to iPhone.
  • The bars show the wrong colour, or change colour as you scroll.
  • Scroll lock, a sheet, a modal or scroll-to-top works on desktop and not on the phone.
  • Choosing svh, lvh or dvh; planning how to test an iPhone-Safari bug.

When NOT to use

  • Native iOS apps — the bars are yours to set; none of this applies.
  • Android Chrome — it has its own tinting model; this one is WebKit's.
  • Responsive layout in general — composing-a-screen; targets and motion modes — frontend-a11y.
Installs
3
GitHub Stars
3
First Seen
13 days ago