feat(pwa): installable PWA (manifest + 빈 SW + SVG 아이콘)

설치 가능한 PWA 자격을 갖추는 최소 셋:
- web/public/manifest.webmanifest: 한국어 name/short_name, 다크 테마 컬러,
  standalone display, /icon.svg (any maskable, sizes any)
- web/public/icon.svg: 다크 배경 + 한국 컬러 캔들(상승=#ef4444 / 하락=#3b82f6)
  + 우상향 추세선. maskable safe-zone (중심 80%) 보존
- web/public/sw.js: install/activate 만 처리 (fetch handler 없음).
  install 자격만 충족하고 네트워크는 그대로 통과 → 캐시 stale 위험 0
- web/components/PwaRegister.tsx: production 빌드에서만 SW 등록,
  실패는 silently 무시
- web/app/layout.tsx: Metadata.manifest/icons/appleWebApp,
  viewport.themeColor/colorScheme 분리 (Next 14 권장)

dev (next dev) 에서는 SW 등록을 우회 — HMR 응답 간섭 회피.
This commit is contained in:
claude-owner
2026-05-28 23:39:27 +09:00
parent 38db4b8c24
commit 89f3a865af
5 changed files with 108 additions and 3 deletions

13
web/public/sw.js Normal file
View File

@@ -0,0 +1,13 @@
// 최소 서비스워커 — PWA install 자격 (manifest + SW) 만 충족시킨다.
// fetch handler 가 없어 네트워크 요청을 가로채지 않음 → 정상 동작은 그대로,
// 캐시 stale 위험 없음. 향후 오프라인 셸/사진 캐싱이 필요하면 여기에 추가.
self.addEventListener("install", () => {
// 이전 버전 SW 를 즉시 교체. 한 페이지 새로고침이면 새 SW 가 active 가 됨.
self.skipWaiting();
});
self.addEventListener("activate", (event) => {
// 모든 열린 탭의 client 를 즉시 control 하도록.
event.waitUntil(self.clients.claim());
});