PWA Checklist

PWA 준비 체크리스트

앱 설치, 오프라인 사용, 캐시, 동기화 흐름을 공개 가능한 범위의 점검 항목으로 정리한 템플릿입니다.

App Manifest앱 이름, 시작 주소, 표시 방식, 테마 색상, 설치 화면 참조 이미지를 점검합니다.

Service Worker등록 실패 대응, 새 버전 감지, 갱신 안내, 이전 캐시 정리 기준을 점검합니다.

CacheApp Shell, 정적 리소스, API 캐시 가능 여부와 만료 기준을 구분합니다.

Offline & Sync오프라인 표시, 로컬 저장, 재시도, 중복 동기화 방지 기준을 점검합니다.

Template

Area	Check Item	Status	Note
App Manifest	앱 이름과 시작 주소를 정의한다.	Required	설치 후 첫 진입 경로 기준
App Manifest	설치 화면에 필요한 이미지 참조를 준비한다.	Required	브랜드 자산은 프로젝트별 대체
Service Worker	등록 실패 시에도 앱 사용이 가능하다.	Required	기본 웹 사용성 유지
Service Worker	새 버전 감지와 갱신 안내 방식을 정한다.	Recommended	사용자 작업 중 강제 갱신 방지
Cache	캐시 가능한 API와 캐시하면 안 되는 API를 구분한다.	Required	개인/민감 데이터 응답 제외
Offline	오프라인 상태를 감지하고 화면에 표시한다.	Required	저장 가능 여부와 함께 표시
Sync	동기화 대기, 진행, 성공, 실패 상태를 구분한다.	Required	상태별 사용자 문구 분리
Sync	네트워크 복구 후 재시도 흐름을 제공한다.	Recommended	수동 재시도 버튼 포함

Copy Block

## App Manifest
- [ ] Define app name and launch URL.
- [ ] Define install display mode and theme colors.
- [ ] Prepare install-screen image references.

## Service Worker
- [ ] Register the service worker.
- [ ] Keep the app usable when registration fails.
- [ ] Define update detection and cache cleanup rules.

## Cache
- [ ] Define app shell cache strategy.
- [ ] Define static resource cache strategy.
- [ ] Separate cacheable APIs from non-cacheable APIs.

## Offline
- [ ] Detect and show offline status.
- [ ] Separate offline-capable features from server-required features.
- [ ] Define recovery flow for local-save failure.

## Sync
- [ ] Define pending, syncing, synced, and failed states.
- [ ] Retry after network restoration.
- [ ] Prevent duplicate sync requests.