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,lvhordvh; 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.