Skip to content

Instantly share code, notes, and snippets.

@fozzedout
fozzedout / iphone-pwa-game-guide.md
Last active November 14, 2026 19:35
iOS Game UI for Web & PWA: A Developer Guide (updated with Safari 26 status bar tinting)

iOS Game UI for Web & PWA: A Developer Guide

A comprehensive guide to building fullscreen web games and PWAs on iPhone, covering safe area insets, Dynamic Island handling, canvas sizing, and the many undocumented gotchas that will waste your time if you don't know about them.

Building a fullscreen web game for iPhone remains one of the most technically frustrating challenges in web development. The core difficulty stems from Apple's layered physical constraints — the Dynamic Island, notch, home indicator, rounded corners — combined with iOS Safari's incomplete web standards support (no Fullscreen API, no orientation lock) and persistent WebKit bugs. This guide covers the foundational patterns, exact pixel values, critical gotchas, and hard-won workarounds.


1. The Foundational CSS Pattern