📦 런타임 dependencies

패키지	RN/Expo 사용	이유/이슈	대체(Expo 호환)	메모/이관 팁
@ebay/nice-modal-react	❌	React DOM 의존(웹 모달)	react-native-modal / react-native-paper(Dialog)	네이티브 모달 API/포털 부재 전제 재설계
@faker-js/faker	✅	순수 JS	동일	시드/로케일만 주의
@gsap/react / gsap	❌	DOM/스타일 속성 기반	react-native-reanimated / moti / react-native-skia	애니메이션 DSL 전면 치환 필요
@react-spring/web	❌	웹 렌더러	@react-spring/native / reanimated	API 유사하지만 props 차이 큼
@stackflow/*	❌	웹 SPA 전용 내비	@react-navigation/native	URL 동기화 제거 필요
@tanstack/react-query	✅	환경 무관	동일	네트워크/포커스 이벤트 브리지 고려
@tanstack/react-query-devtools	⚠️	웹 Devtools UI	Flipper 플러그인 / react-query-native-devtools	웹 전용 UI는 불가
@tanstack/react-virtual	❌	DOM 측정 의존	FlashList / RecyclerListView / FlatList	가상스크롤 대체
@types/node	❌	Node 전용 타입	불필요	RN 런타임에 Node 전역 없음
@use-gesture/react	❌	포인터/DOM 제스처	react-native-gesture-handler + reanimated	제스처 모델 전환
axios	✅	환경 무관	동일(fetch 대안)	파일 업/다운은 expo-file-system 병행
clsx	✅	순수 JS	동일	RN에 class 개념 없음
dayjs	✅	순수 JS	동일	타임존 플러그인 고려
env-cmd	❌	빌드/노드 스크립트	Expo env plugin / app.config.js	런타임 주입 방식 변경
es-toolkit	✅	순수 JS	동일	번들 크기 확인
glob	❌	Node FS 의존	개발 단계에서만	앱 코드에서 사용 불가
he	✅	순수 JS	동일	문제 없음
hostile	❌	hosts 파일 수정(Node)	불가	RN 환경 무의미
immer	✅	순수 JS	동일	성능 문제 거의 없음
jwt-decode	✅	순수 JS	동일	토큰 저장소는 expo-secure-store 권장
lottie-web	❌	DOM/Canvas	lottie-react-native	JSON 애니메이션 재사용 가능
oidc-client-ts	❌	브라우저 OIDC 흐름/스토리지	expo-auth-session / react-native-app-auth	리다이렉트/PKCE 재구성 필요
qs	✅	순수 JS	동일	URLSearchParams 대안 검토
react (19.1.0)	⚠️	RN은 Expo SDK 대응 버전 필요	Expo 지정 버전	React 18 계열로 다운 가능성 있음
react-dom	❌	RN 비사용	불필요	제거
react-hook-form	✅	RN 지원	동일	UI 컴포넌트 예제 치환 필요
react-loading-skeleton	❌	DOM/CSS 스켈레톤	moti/skeleton / react-native-skeleton-content	스타일 전환 필요
react-multi-date-picker	❌	웹 전용	@react-native-community/datetimepicker / react-native-calendars	UX 단순화 권장
swiper	❌	웹 Swiper DOM 기반	react-native-swiper / react-native-swiper-flatlist	제스처 충돌 주의
type-fest	✅	TS 타입	동일	문제 없음
uuid	✅	순수 JS	동일	RN 환경에서 정상 동작
zustand	✅	환경 무관	동일	persist는 mmkv/AsyncStorage 어댑터 사용

---

🔧 devDependencies

패키지	RN/Expo 사용	이유/이슈	대체(Expo 호환)	메모/이관 팁
@biomejs/biome	✅	도구 체인	동일	RN에도 유효
@types/he / @types/qs	✅	타입 정의	동일	문제 없음
@types/navermaps	❌	웹 네이버맵	react-native-nmap 타입(커뮤니티) / 자체 d.ts	Dev Client 필요 가능
@types/react / @types/react-dom	⚠️	RN은 react-dom 불필요	RN 대응 타입만 유지	react-dom 타입 제거 권장
@vitejs/*, vite, vite-plugin-html, vite-tsconfig-paths	❌	웹 번들러	Expo Metro	전면 제거
@vitejs/plugin-basic-ssl	❌	개발 서버 SSL	Expo Dev Client / LAN 모드	불필요
@vitejs/plugin-react	❌	Vite 전용	불필요	제거
globals	✅	린팅 보조	동일	유지 가능
husky / lint-staged	✅	Git 훅	동일	유지 가능
sass	❌	CSS/Sass 파이프라인	styled-components/native / nativewind	RN은 CSS 미지원
stylelint	⚠️	CSS 린트	RN 의미 적음	제거 가능
swagger-typescript-api	✅	코드젠(Node)	동일	API 타입 생성 파이프라인 유지
typescript (~5.8.3)	✅	언어	Expo 권장 버전	RN 템플릿에 맞춰 정렬 필요

---

🚀 이관 핵심 체크리스트

• 네비게이션: @stackflow/* → React Navigation
• 제스처/애니메이션: gsap, react-spring/web, @use-gesture/react → reanimated + gesture-handler + moti
• 리스트 가상화: react-virtual → FlashList / RecyclerListView
• UI/스타일: Sass/CSS 기반 제거 → StyleSheet / styled-components/native / nativewind
• Lottie: lottie-web → lottie-react-native
• 인증(OIDC): oidc-client-ts → expo-auth-session / react-native-app-auth
• 지도: 웹 SDK 제거 → react-native-nmap / react-native-maps
• 번들링: Vite → Metro (Expo 기본)
• React 버전: Expo SDK에 맞춰 React 18 계열 사용