WebView 하단 탭바를 Link와 idle prefetch로 가볍게 만든 기록
Next.js App Router + Flutter WebView에서 전역 5탭·금 모으기 4탭 하단바의 전환 지연, 초기 prefetch 부담, 입장 애니메이션을 라우팅 모델에 맞춰 나눠 푼 과정입니다.
하단 탭의 prefetch를 끄면 탭 전환이 느리고, 켜면 첫 화면이 무거웠습니다. 전역 하단바는 마운트되자마자 5개 대형 라우트를 한꺼번에 선로딩했고, withViewTransition + router.push 조합은 탭을 눌러도 늦게 바뀌거나 깜빡였습니다.
사내 B2C WebView(Next.js App Router + Flutter WebView)에서 전역 5탭 하단바와 금 모으기 4탭 하단바를 다루며 체감 성능, 애니메이션 일관성, 초기 로드 부담을 맞춘 작업입니다. 풀이는 세 가지였습니다. 탭 이동은 Link 기본 네비로 돌리고, prefetch는 idle + 의도 두 단계로 나누고, 아이콘 애니메이션은 두 하단바가 공유하되 서로 간섭하지 않게 했습니다.
풀 라우트 전환을 하는 전역 탭바가 느리고 무거웠다
증상
- 탭을 눌러도 늦게 바뀌거나 깜빡였습니다.
withViewTransition+router.push조합이 App Router 클라이언트 전환과 맞지 않았습니다. prefetch를 전 탭에 켜 두면 마운트 시 5개 대형 라우트가 한꺼번에 선로딩됐습니다.
같은 하단바, 다른 라우팅 모델
| 구분 | 내용 |
|---|---|
| 환경 | Next.js App Router + Flutter WebView |
하단 네비는 두 갈래입니다.
- 전역 5탭: 앱 전체에서 쓰는 메인 하단바 (홈, 금 모으기, MY 금고, 내역, 금거래소 등)
- 금 모으기 4탭:
collect-gold탭 쉘 안에서만 쓰는 전용 하단바 (홈, 친구적립 + coming soon 2개)
같은 "하단바"처럼 보여도 라우팅 모델이 달라서 prefetch·애니메이션·gate 처리 전략을 나눴습니다.
전역 5탭: 컴포넌트·데이터 흐름
탭 구성 (좌 → 우)
홈 · 금 모으기 · MY 금고 · 내역 · 금거래소 (실제 라벨/아이콘은 서비스 스펙 기준)

금 모으기 4탭: keep-alive
탭 클릭 시 (같은 쉘 · URL만 변경)
[홈] ──Link──▶ /collect-gold
[친구적립] ──▶ /collect-gold/friend-referral
CollectGoldTabPanelHost
│
┌─────────┴─────────┐
▼ ▼
home 패널 friend 패널
display:block display:none ← 한쪽만 visible (hidden 클래스)
하단 CollectGoldBottomNav 는 리마운트 없음 (레이아웃에 1회만 마운트)
그래서 전략이 갈린다
| 금 모으기 4탭 | 전역 5탭 | |
|---|---|---|
| 라우팅 | 같은 탭 쉘 안 keep-alive (CollectGoldTabPanelHost) — URL만 바뀌고 패널은 hidden 토글 | 탭마다 풀 라우트 전환 (별도 page.tsx 트리) |
| 하단 UI | CollectGoldBottomNav | BottomNavigation + BottomNavGateClient |
| prefetch 부담 | 4탭·같은 쉘 → 상대적으로 가벼움 | 5개 대형 라우트 동시 prefetch 시 초기 부담이 크게 드러남 |
| 입장 애니 scope | collectGold | global |
문제가 커지는 쪽은 풀 라우트 전환을 하는 전역 5탭입니다.
prefetch를 끌까 켤까, 전환을 어떻게 할까
prefetch: 전부 켜기 vs 전부 끄기 vs 단계 나누기
| 선택지 | 이득 | 비용 |
|---|---|---|
| 전 탭 prefetch 켜기 | 탭 전환이 빠름 | 마운트 시 5개 대형 라우트 동시 선로딩, 첫 화면이 무거움 |
| 전 탭 prefetch 끄기 | 초기 로드가 가벼움 | 탭 전환이 느림 |
| idle + 의도 두 단계 | 고빈도 탭은 미리, 나머지는 손이 갈 때만 | 훅·설정 파일을 따로 관리 |
"prefetch를 끄면 느리고, 켜면 첫 화면이 무거운" 딜레마를 한 번에 풀지 않고 단계를 나눴습니다.
전환: View Transition + router.push vs Link 기본 네비
imperative router.push에 View Transition을 얹으면 전환 연출은 직접 쥘 수 있지만, App Router 클라이언트 전환과 맞지 않아 지연·깜빡임이 났습니다. 브라우저·WebView가 익숙한 Link 기본 네비로 돌리는 쪽을 골랐습니다.
전역 탭까지 keep-alive할까
금 모으기 4탭처럼 전역 탭에도 부분 keep-alive나 parallel route를 적용하는 방법도 있었습니다. 다만 범위가 커서, 이번에는 prefetch·gate·애니 공통화에 집중했습니다.
애니메이션: 하나로 합칠까, scope를 나눌까
두 하단바가 같은 모션 컴포넌트를 쓰면 UX는 맞출 수 있지만, 세션당 1회 입장 애니가 서로 간섭할 수 있습니다. 그래서 컴포넌트는 공유하고 scope와 storage는 나눴습니다.
Link 전환, 두 단계 prefetch, 공통 애니메이션
전역 탭 전환: router.push 대신 Link
- 탭 이동을 Next.js
Link기본 네비로 통일 (scroll={false}유지) - View Transition + imperative
router.push제거
브라우저·WebView가 익숙한 네비게이션 경로로 돌려서 "눌렀는데 늦게 바뀌는" 느낌을 줄였습니다. 남은 건 선로딩 문제입니다.
prefetch를 idle과 의도 두 단계로 나누기
두 하단바가 같은 훅을 씁니다.
하단바 mount
│
├─① Link prefetch={false} ← 즉시 5탭 동시 로드 ❌
│
├─② idle (requestIdleCallback)
│ 전역: / 와 /collect-gold 만 (현재 탭 제외)
│ 금모으기: /collect-gold, 친구적립 href
│
└─③ onPointerEnter / onTouchStart
손·마우스 올린 탭만 router.prefetch(href)원칙
Link prefetch={false}— 마운트 시 모든 탭 동시 선로딩 방지- 의도 prefetch —
onPointerEnter/onTouchStart에서router.prefetch(href) - idle 선로딩 —
requestIdleCallback(미지원 시 1.5s timeout) 이후 고빈도 탭만 1~2개 - 중복·현재 탭 스킵 —
Set으로 이미 prefetch한 href 제외, 활성 탭은 생략
구현
| 파일 | 설명 |
|---|---|
useBottomNavRoutePrefetch.ts | 공통 훅 |
bottomNavPrefetch.config.ts | 전역 idle: /, /collect-gold |
CollectGoldBottomNav.tsx | idle: /collect-gold, 친구적립 href |
BottomNavigation.tsx | 전역 5탭 연동 |
idle 대상
| 네비 | idle prefetch | 호버/터치만 |
|---|---|---|
| 전역 5탭 | 홈, 금 모으기 | MY 금고, 내역, 금거래소 등 |
| 금 모으기 4탭 | 홈, 친구적립 | (coming soon 탭 제외) |
아이콘 입장·재탭 애니메이션 공통화
전환과 로딩을 정리한 뒤에는 두 하단바의 모션을 맞췄습니다.
- 탭 아이콘만 스태거 scale 입장 (라벨은 고정)
- 세션당 입장 애니 1회만 재생
- 활성 탭 재탭 시 아이콘 pulse (햅틱 포함)
| 파일 | 역할 |
|---|---|
BottomNavIconEntrance.tsx | Framer Motion scale, scope: global / collectGold |
useBottomNavIconEntranceOrchestration.ts | 입장 1회·탭 전환·재탭 pulse 오케스트레이션 |
bottomNavIconEntrance.const.ts | stagger·duration 상수 |
bottomNavEntranceSession.tsx | Provider (전역 / 금 모으기 분리) |
금 모으기는 CollectGoldBottomNav.tsx + collectGoldBottomNavEntranceSession.storage.ts(sessionStorage 키 분리), 전역은 BottomNavigation.tsx + bottomNavEntranceSession.storage.ts를 씁니다.
두 하단바가 같은 UX를 내면서도 입장 애니가 서로 간섭하지 않도록 scope와 storage를 나눴습니다.
금 모으기 탭 쉘: 첫 진입 데이터
하단바 최적화와 별도로, 탭 쉘은 서버 prefetch로 첫 진입 데이터를 맞춥니다.
| 파일 | 역할 |
|---|---|
collect-gold/(tab-shell)/layout.tsx | 탭 쉘 레이아웃 |
prefetchCollectGoldTabShell.ts | React Query prefetch |
CollectGoldTabPanelHost.tsx | keep-alive 패널 호스트 |
테스트로 고정한 동작과 체감 변화
테스트로 고정한 동작
| 테스트 | 검증 내용 |
|---|---|
useBottomNavRoutePrefetch | intent / 현재 탭 스킵 / idle prefetch |
BottomNavigation | hover 시 router.prefetch |
CollectGoldBottomNav | Link prefetch={false}, scroll={false} |
useBottomNavIconEntranceOrchestration | 입장·재탭 pulse |
체감 변화
- 전역 탭은
Link기본 네비로 돌린 뒤 "눌렀는데 늦게 바뀌는" 느낌이 줄었습니다. - 금 모으기 탭은 재방문 시 이미 마운트된 패널을
hidden으로 토글하므로, 전역 5탭보다 전환 체감이 가볍습니다.
남은 한계
전역 탭에는 keep-alive를 적용하지 않았습니다. 금 모으기 4탭처럼 keep-alive를 전역 탭까지 넓힐 수 있을지가 남은 질문입니다.
배운 것
WebView + App Router 조합에서는 "보이는 것(하단바)"과 "로드되는 것(prefetch)" 을 분리해서 설계하는 편이 체감에 가장 잘 먹혔습니다.
같은 주제의 글
CSR 앱에 ISR을 도입하며 SWR로 hydrate를 직접 구현한 기록
CSR로만 돌던 App Router 웹뷰 앱에 ISR을 도입하면서, React Query의 hydrate 대신 SWR fallback과 unstable_serialize로 서버 데이터를 클라이언트에 넘긴 과정을 정리했습니다.
Next.js 정적 파일을 S3·CloudFront로 옮겨 CPU 스파이크 줄이기
assetPrefix로 /_next/static만 S3 + CloudFront(OAC)로 분리한 구조와 배포 후 캐시 무효화 순서, 같이 챙겨야 했던 이미지 허용·빌드 OOM 설정을 정리했습니다.
허용 도메인만 열린 교육청 망에서 S3 이미지를 nginx 리버스 프록시로 띄운 기록
서울시교육청 시범 도입 중 화이트리스트 망에서 S3 이미지가 막히자, 이미 허용된 API 도메인 뒤에 nginx 리버스 프록시를 두어 이미지를 서빙한 과정과 트레이드오프를 정리했습니다.