글방

개인용 웹소설 클라우드 리더. 한국 웹소설 .txt 파일을 업로드하면 기기와 무관하게 이어읽기가 가능한 서비스가 목적이다.

초기 설계는 메타데이터는 Firestore, 텍스트 원본은 Firebase Storage에 두는 하이브리드 구조였다. 실제 구현 중 Storage의 CORS 오류, 권한 설정 복잡성, 30MB 업로드 제한에 막혀 아키텍처를 뒤엎고 텍스트를 50KB 청크로 쪼개 Firestore에 병렬 저장하는 방식으로 전환했다. 이후 청크 정렬 문제, 레이스 컨디션, write batch 한도 초과, Firestore offline 오류를 순서대로 잡았고, CI 배포 권한 부족으로 Firestore rules 배포는 CI에서 빼고 Hosting만 자동배포하도록 축소했다.

• React 19 + Vite 8 — Concurrent 렌더링으로 대용량 텍스트 페이지네이션 시 UI 블로킹 방지, 빠른 HMR
• Panda CSS — 런타임 오버헤드 없는 타입 안전 CSS-in-JS
• Firebase Firestore v10 — Storage 대비 권한 설정이 단순하고 Offline Persistence로 PWA 지원
• jschardet — 한국 웹소설 특유의 EUC-KR 인코딩을 자동 감지해 UTF-8로 변환

geul-bang.web.app으로 실제 배포되어 GitHub Actions로 main 푸시 시 자동 배포된다. Phase 1 MVP는 완료했고 Phase 2(페이지 모드, 검색, 북마크, PWA 오프라인)는 일부 진행 중이다.