웨딩북 웹앱 - React to Next 마이그레이션

앱 전용 React WebView를 웹과 PC에서 접근 가능한 Next.js 서비스로 전환하고 별도 Registry 커머스(Store)까지 통합한 작업

기간
2025.12 ~ 2026.03
역할
공동 설계 및 구현 주도
키워드
React Migration, Registry Integration, WebView Auth

프로젝트 개요

앱 WebView에서만 제공하던 React 서비스를 웹과 PC에서도 사용할 수 있는 Next.js 플랫폼으로 전환한 프로젝트입니다. Registry 커머스를 함께 통합하고 기존 사용자의 로그인과 앱 이동 흐름이 전환 이후에도 이어지도록 구현했습니다.

주요 기능

  1. WebView 전용 화면을 웹과 PC로 확장

    앱 안에서만 접근하던 React 화면을 일반 웹 브라우저와 PC에서도 사용할 수 있도록 Next.js App Router 기반 웹앱으로 옮겼습니다.

  2. Registry 커머스 통합

    별도 프로젝트였던 Registry의 상품 탐색부터 장바구니, 결제, 위시리스트, 주문과 문의, 비회원 결제까지 Next.js의 /store 영역으로 통합했습니다.

  3. 기존 사용자 로그인 유지

    기존 앱과 Registry를 사용하던 사용자가 서비스 전환 이후에도 로그인 상태를 이어갈 수 있게 했습니다.

  4. 웹과 앱에 맞는 화면 이동

    일반 웹과 앱 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를 읽는 컴포넌트는 서버 렌더링에서 제외해 빌드가 멈추지 않게 했습니다.
ASK ME기준 ·이 프로젝트 · 웨딩북 웹앱 - React to Next 마이그레이션

프로젝트, 담당 범위, 기술적 판단을 물어보세요.

추천 질문

포트폴리오에 작성된 내용으로만 답합니다