Skip to content

fix: iOS 설치형 PWA 상단 UI 블러 및 safe area 겹침 수정 - #53

Merged
devswha merged 1 commit into
devswha:mainfrom
Yoonwoo-Ha:fix/ios-pwa-safe-area
Aug 17, 2026
Merged

fix: iOS 설치형 PWA 상단 UI 블러 및 safe area 겹침 수정#53
devswha merged 1 commit into
devswha:mainfrom
Yoonwoo-Ha:fix/ios-pwa-safe-area

Conversation

@Yoonwoo-Ha

Copy link
Copy Markdown
Contributor

배경

iOS Safari에서는 정상으로 보이지만 홈 화면에 설치한 PWA에서는 상태 표시줄 영역이 앱 콘텐츠 위에 반투명하게 겹쳤습니다. 이 때문에 햄버거 버튼, 대화 제목, 로고 등 상단 UI가 흐려지거나 잘린 것처럼 보였습니다.

원인

  • apple-mobile-web-app-status-bar-styleblack-translucent가 설치형 PWA에서 웹 콘텐츠를 상태 표시줄 아래까지 확장했습니다.
  • 앱 상단 영역에도 backdrop-blur와 반투명 배경이 적용되어 iOS 네이티브 상태 표시줄 효과와 중첩됐습니다.
  • safe-area 보정 규칙이 Tailwind @layer base에 있어 뒤에서 생성되는 .inset-0 유틸리티에 덮이는 경우가 있었습니다.

변경 사항

  • 설치형 PWA 상태 표시줄 스타일을 black-translucent에서 black으로 변경했습니다.
  • 상태 표시줄 전용 pwa-status-bar-surface를 추가하고 앱 콘텐츠와 분리했습니다.
  • standalone 모드에서 앱 셸과 전체 화면 오버레이가 env(safe-area-inset-top) 아래에서 시작하도록 했습니다.
  • Tailwind 유틸리티와의 우선순위 충돌을 막기 위해 safe-area 위치값을 명시적으로 우선 적용했습니다.
  • 사이드바와 빈 상태 헤더의 반투명 배경 및 blur를 제거해 상단 UI를 선명하게 유지했습니다.
  • 브라우저 실행 모드에는 기존 레이아웃 변화가 없도록 standalone PWA에만 적용했습니다.

검증

  • 관련 Node 테스트 17개 통과
  • npm run typecheck 통과
  • npm run lint 통과
  • npm run build:client 통과
  • iOS 설치형 PWA용 메타 태그와 safe-area 회귀 테스트 추가

참고

상태 표시줄 메타 설정은 iOS가 설치 시 캐시할 수 있으므로 기존 홈 화면 앱에서는 삭제 후 Safari에서 다시 홈 화면에 추가해야 변경이 확실히 반영됩니다.

@devswha
devswha merged commit 8ccc743 into devswha:main Aug 17, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants