<aside>
🚀
본 문서에서는 현재 서비스의 핵심 경험인 App 영역을 기준으로 기술 스택 검토를 우선 진행했다.
구현 범위 및 단계적 확장 전략
본 프로젝트는 P0 단계에서 모바일 앱(PWA) 경험을 기준으로 핵심 흐름을 완성하는 것을 목표로 한다.
앱과 웹 UI를 페이지 단위로 병행하여 구현할 경우,
- 동일한 기능에 대해 UI/인터랙션 규칙을 반복적으로 재설계하게 되고
- 디자인 및 기능 설계 측면에서 불필요한 피로도가 증가할 가능성이 크다.
이에 따라 P0 단계에서는 앱(UI)을 기준으로 전체 End-to-End 흐름을 먼저 완성하고,
P1 단계부터 데스크톱 웹 환경에 맞게 UI를 확장하는 전략을 선택할 예정이다.
웹 확장 단계에서는 앱에서 확정된 상태 모델, 도메인 로직, 사용자 흐름을 그대로 유지한 채,
데스크톱 환경에 적합한 레이아웃(패널, 분할 뷰, hover 인터랙션 등)을
추가하는 방식으로 진행할 예정이다.
이 방식을 통해 중복 설계 비용을 줄이고, 환경 특성에 맞는 UI 품질을 확보하고자 한다.
</aside>
App 영역 기준 (React PWA)
- :react: React (Vite)
- :zustand: Zustand – 클라이언트 상태 관리
- :tanstack: TanStack Query – 서버 상태 관리 (선별적 사용)
- :react-router: Router (React Router)
- :tailwind_css: Tailwind CSS – 스타일링
- :zod: Zod - 데이터 검증
- :vitest: Vitest - 단위 테스트
- Testing Library (React) - UI 테스트
- StoryBock - 컴포넌트 테스트
Cypress - 통합 테스트
- IndexedDB - 경량 브라우저 DB
- Service Worker 👷♂️
TL;DR
최종 기술 스택 요약
Core
- React (Vite)
- Zustand
- React Router