웨딩북 웹앱 - React to Next 마이그레이션
앱 전용 React WebView를 웹과 PC에서 접근 가능한 Next.js 서비스로 전환하고 별도 Registry 커머스(Store)까지 통합한 작업
프로젝트 개요
앱 WebView에서만 제공하던 React 서비스를 웹과 PC에서도 사용할 수 있는 Next.js 플랫폼으로 전환한 프로젝트입니다. Registry 커머스를 함께 통합하고 기존 사용자의 로그인과 앱 이동 흐름이 전환 이후에도 이어지도록 구현했습니다.
주요 기능
WebView 전용 화면을 웹과 PC로 확장
앱 안에서만 접근하던 React 화면을 일반 웹 브라우저와 PC에서도 사용할 수 있도록 Next.js App Router 기반 웹앱으로 옮겼습니다.
Registry 커머스 통합
별도 프로젝트였던 Registry의 상품 탐색부터 장바구니, 결제, 위시리스트, 주문과 문의, 비회원 결제까지 Next.js의 /store 영역으로 통합했습니다.
기존 사용자 로그인 유지
기존 앱과 Registry를 사용하던 사용자가 서비스 전환 이후에도 로그인 상태를 이어갈 수 있게 했습니다.
웹과 앱에 맞는 화면 이동
일반 웹과 앱 WebView에서 뒤로가기, 외부 이동과 서비스 간 링크가 각 환경에 맞게 동작하도록 구성했습니다.
기술 스택
Next.js · React · TypeScript · App Router · TanStack React Query · Zustand · Axios · SCSS Modules · WebView Bridge · Middleware
담당 범위와 결과
역할 · 공동 설계 및 구현 주도
Registry 커머스를 Next.js 웹앱 안으로 통합
- 상품 탐색과 상세부터 장바구니, 결제, 위시리스트, 주문과 문의까지 별도 서비스를 /store 영역으로 옮겼습니다.
- 로그인 사용자와 비회원의 구매 흐름을 모두 지원하면서 하나의 웹앱에서 서비스를 운영할 수 있게 했습니다.
기존 사용자의 인증과 앱 이동 흐름 유지
- 신규 도메인 전환 이후에도 기존 사용자가 다시 로그인하지 않고 서비스를 이어갈 수 있게 했습니다.
- 웹과 앱의 이동 규칙을 usePageRouter로 모으고, 302개 파일의 useRouter 호출을 한 번에 교체했습니다.
- 기존 useSchemeNavigate와 useOpenUrl을 이 훅으로 통합해 앱 스킴 링크, 외부 링크, 뒤로가기를 처리했습니다.
앱처럼 넘어가는 화면 전환
- App Router는 페이지가 바뀌는 즉시 이전 화면을 교체해 퇴장 애니메이션을 넣을 수 없었습니다. 애니메이션 동안 Next 내부 라우터 context를 고정해 이전 페이지를 유지했습니다.
- 퇴장 중인 페이지가 새 경로의 값을 읽어 의도치 않게 redirect되지 않도록 pathname과 searchParams도 함께 고정하고, 같은 페이지 안의 탭 전환은 고정하지 않았습니다.
- 홈, 스토어, 마이페이지는 다른 화면에 다녀와도 상태가 유지되도록 keep-alive로 두었습니다. Next 내부 API에 의존하므로 버전 업그레이드 시 확인이 필요한 한계가 있습니다.
검색 노출과 SSR 빌드 오류 해결
- 상품 상세 메타데이터와 sitemap을 구성해 앱 밖에서도 서비스를 찾고 공유할 수 있게 했습니다.
- useSearchParams를 쓰는 페이지는 Suspense로 감싸고 window를 읽는 컴포넌트는 서버 렌더링에서 제외해 빌드가 멈추지 않게 했습니다.