Codex Phone Lab
이 스킬을 사용하여 제품 프롬프트를 사용자가 실제 휴대폰에서 Expo Go로 열 수 있는 React Native/Expo 앱으로 전환하세요. 시뮬레이터, 네이티브 빌드, TestFlight 또는 앱 스토어 배포를 고려하기 전에 빠른 "프롬프트 → 앱 → 휴대폰" 루프에 최적화하세요.
운영 모델
사용자가 명시적으로 네이티브 iOS/Android 모듈을 요구하지 않는 한 이 경로를 선호하세요:
scripts/doctor.sh로 로컬 사전 요구 사항을 확인합니다.- 모바일 프로젝트가 없으면
scripts/new-expo-app.sh <app-name>으로 Expo 앱을 생성합니다. 이 명령은 기본적으로expo-template-default@sdk-54를 사용하여 현재 워크플로에서 사용하는 Expo Go 버전에서 열리도록 합니다. - 첫 번째 사용 가능한 화면을 빠르게 빌드합니다. 랜딩 페이지를 만들지 마세요.
scripts/start-phone-preview.sh [lan|tunnel|local]로 휴대폰 프리뷰를 시작합니다.- 편집하는 동안 개발 서버를 계속 실행합니다. Metro/Expo 로그를 사용하여 런타임 오류를 수정합니다.
- 사용자에게 Expo Go를 설치하고 QR을 스캔하며 LAN 모드의 경우 휴대폰을 동일한 네트워크에 유지하도록 안내합니다.
- 작고 눈에 띄는 변경으로 반복합니다: 편집, 로그 관찰, 새로고침, 수정.
프로젝트 감지
새 앱을 만들기 전에 현재 디렉토리를 검사합니다:
package.json에expo종속성이 있는 경우: 기존 Expo 앱으로 처리합니다.app.json,app.config.*,app/또는expo-router가 있는 경우: 종속성 설치가 필요하더라도 Expo 앱으로 처리합니다.ios/및android/가 있지만 Expo가 없는 경우: 사용자에게 Expo 마이그레이션이 필요한지 묻고, 그렇지 않으면 기존 스택을 유지합니다.- 빈 디렉토리: SDK 54 템플릿으로 새 Expo 앱을 생성합니다.
휴대폰 프리뷰
첫 번째 "와우" 데모에는 Expo Go를 사용하세요. App Store/TestFlight의 마찰을 피할 수 있습니다.
기본적으로 SDK 54를 사용합니다. 이 워크플로의 현재 Expo Go는 SDK 55 프로젝트를 "프로젝트가 이 버전의 Expo Go와 호환되지 않습니다"라는 메시지와 함께 거부합니다. 사용자의 Expo Go가 최신 SDK를 지원하는 것으로 알려진 경우에만 재정의하세요:
CODEX_PHONE_LAB_EXPO_TEMPLATE=expo-template-default@sdk-55 <skill-dir>/scripts/new-expo-app.sh my-app
실행:
<skill-dir>/scripts/start-phone-preview.sh lan
휴대폰이 동일한 Wi-Fi에 없거나 LAN 모드로 연결할 수 없는 경우 tunnel을 사용하세요. 터널 모드는 Expo에 터널링 종속성을 설치하도록 요청할 수 있습니다.
사용자 워크플로:
- 휴대폰에 Expo Go를 설치합니다.
- 프리뷰 명령을 실행합니다.
- Expo Go 또는 휴대폰 카메라에서 QR 코드를 스캔합니다.
- 터미널을 열어 둡니다. 앱 편집 내용이 실시간으로 새로고침됩니다.
앱 빌드 지침
첫 번째 화면이 실제 앱처럼 느껴지도록 만드세요:
- 안전 영역과 모바일 크기 레이아웃을 사용하세요.
- 실제 상호작용을 구축하세요: 양식, 목록, 탐색, 토글, 타이머, 모의 데이터 또는 상태.
- 워크플로가 암시하는 경우 로딩, 빈 상태 및 오류 상태를 포함하세요.
- 모바일에 적합한 간결한 타이포그래피를 유지하세요.
- 웹 랜딩 페이지 패턴, 과도한 크기의 히어로 섹션, 중첩 카드 및 설명적인 인앱 텍스트를 피하세요.
- 템플릿에 이미 포함된 경우 다중 화면 앱에는 Expo Router를 선호하세요.
배포 결정
사용자의 목표에 가장 적합한 가벼운 경로를 선택하세요:
- 사용자 휴대폰에서 빠른 프로토타입: Expo Go QR.
- 사용자 정의 네이티브 모듈이 있는 앱: Expo 개발 빌드.
- iPhone에서 베타 사용자: EAS/Apple Developer 계정을 통한 TestFlight.
- 공개 릴리스: App Store / Play Store 제출.
Expo Go가 프로덕션 배포라고 암시하지 마세요. 이는 라이브 개발 프리뷰입니다.
참고 자료
Expo Go, 개발 빌드, TestFlight 및 앱 스토어 릴리스 중에서 결정할 때 references/expo-phone-workflow.md를 읽으세요.