React Native Local Dev Starter Recipe (for Cursor AI / IOS)

이 레시피는 Cursor AI와 함께 React Native 로컬 개발 환경을 광속으로 구축하고, 첫 빌드까지 성공시키는 과정을 담고 있습니다. (iOS / metro 버전)
[프로젝트명/위치]

1. 프로젝트 초기화 (Initialization)
최신 React Native 커뮤니티 CLI를 사용하여 프로젝트 뼈대를 생성합니다.

프로젝트 생성: npx @react-native-community/cli init

특정 버전 설치 (필요시): npx @react-native-community/cli init --version 0.74.0

2. 환경 점검 (Health Check)
개발에 필요한 SDK, JDK, CocoaPods 등이 잘 설치되어 있는지 확인합니다.

네이티브 환경 진단: npx react-native doctor

3. 의존성 설치 및 설정
iOS 개발을 위해 필요한 라이브러리를 설치합니다. (macOS 환경 한정)

iOS 포드 설치: cd ios && pod install && cd ..

4. 앱 실행 및 디버깅 (Run & Debug)
에뮬레이터나 시뮬레이터를 통해 앱을 구동합니다.

iOS 실행: npx react-native run-ios

Metro 서버 단독 실행: npx react-native start --reset-cache

5. UI 프레임워크 및 유틸리티 추가 (추천)
모바일 앱 개발 속도를 높여주는 필수 도구들을 세팅합니다.

스타일링 도구: npm install nativewind tailwindcss (모바일용 Tailwind)

참조 디펜던시 :
    "react": "19.1.0",
    "react-native": "^0.80.1",
    "react-native-device-info": "^15.0.1",
    "react-native-image-picker": "^8.2.1",
    "react-native-image-viewing": "^0.2.2",
    "react-native-keyboard-aware-scroll-view": "^0.9.5",
    "react-native-safe-area-context": "^5.7.0",
    "react-native-screens": "^4.24.0",
    "react-native-svg": "^15.15.1"

💡 위 내용을 기준으로 작업을 시작해.
"새로운 React Native 프로젝트를 로컬에 세팅하려고 해. 다음 작업을 순차적으로 진행해줘:
설치할때 ios에서 필요한 부분을 먼저 설치해줘. 오래걸릴작업은 주기적으로 체크해서 상황보고해주고, 
ios환경설치이후, rn 환경에 대해 시작하면 될것 같아.
 
npx react-native doctor를 실행해서 내 개발 환경에 문제가 없는지 먼저 체크해줘.

만약 빠진 설정이 있다면 설치 명령어를 알려주고, 문제가 없다면 바로 프로젝트를 생성해줘.

메인 화면(App.tsx)의 기본 코드를 모두 지우고, 깔끔한 화이트 톤의 랜딩 페이지로 교체해줘.

마지막으로 내 환경에 맞춰 run-android나 run-ios 중 가능한 명령어를 실행해서 첫 빌드 화면을 보여줘.

내가 제시한 디펜던시는 이런걸 썼음 좋겠다에 대한 부분이니 참고만해. metro를 사용하면서 충돌날 디펜던시는 제외해야해.

해당부분은 간단하게 실행할수 있게 실행명령어 통합하고 완성된 명령어를 알려줘.