> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# 모바일 개요

같은 서버 측 기반에 연결된 Expo 화면.

## 첫 번째 모바일 세션

근처에 휴대폰이나 설치된 시뮬레이터를 사용하여 컴퓨터에서 아래 모바일 튜토리얼을 따르세요. 프로젝트를 설치하고 apps/mobile/.env.local에 공개 API 주소를 쓰고 Expo QR 코드를 스캔합니다. Expo는 장치에서 React Native 화면을 여는 개발 도구입니다.

Next.js API 및 공유 서버 패키지는 계정, 데이터 및 권한의 소스로 남아 있습니다. 이는 전화기가 통신하는 실행 중인 웹 백엔드입니다. Expo의 QR 서버는 화면 코드만 전달합니다. 미리 보기가 성공했다고 해서 백엔드, 로그인 또는 스토어 구매가 구성되었다는 의미는 아닙니다. 튜토리얼에서는 각 경계를 순서대로 테스트하는 방법을 보여줍니다.

[전체 모바일 첫 실행 튜토리얼을 따르세요](https://supastack.dev/ko/docs/mobile/ship-in-5-minutes.md)

[도구 설치 및 코드 받기](https://supastack.dev/ko/docs/web/before-you-start.md)

[명령어 실행 및 파일 편집 방법 알아보기](https://supastack.dev/ko/docs/web/terminal-basics.md)


## 계약은 공유하고 프레젠테이션은 네이티브로

Expo에는 기본 로그인 및 세션 처리, 작업 공간 및 설정 화면, 채팅 제어, RevenueCat 구매 워크플로가 포함되어 있습니다. Next.js API 및 공유 서버 패키지는 공유 데이터, 인증 및 공급자 확인을 위한 소스로 남아 있습니다. 기본 화면은 서버 자격 증명을 포함하는 대신 이를 호출합니다.

Expo 애플리케이션은 apps/mobile.에 있습니다. 이는 서버 자격 증명을 내장하는 대신 API를 통해 공유 기반을 사용합니다. 기본 인증, 보안 세션 저장소, 딥 링크, 채팅 제어 및 RevenueCat 구매 프레젠테이션에는 각각 클라이언트 모듈이 있습니다.


## API와 앱 스킴 구성

EXPO_PUBLIC_API_URL을 에뮬레이터나 물리적 디바이스가 도달할 수 있는 API 오리진으로 설정하세요. 폰에서 localhost는 그 폰을 의미하므로 적절한 도달 가능한 개발 호스트를 사용하세요. EXPO_PUBLIC_APP_SCHEME은 앱의 딥링크 스킴을 식별합니다.

콜백을 테스트하기 전에 apps/mobile/app.config.ts와 인증 구성을 검토하세요. Expo 공개 값은 클라이언트에 번들되므로 프로바이더 시크릿을 포함해서는 안 됩니다.


## 대상 디바이스에서 검증

결정론적 세션 저장, 딥 링크, 채팅 취소 및 권한 부여 테스트를 먼저 실행하세요. 그런 다음 의도한 EAS 개발 빌드에서 로그인 반환, 세션 복원, 로그아웃 및 구매 동기화를 확인합니다. Expo Go는 실제 매장 구매를 확인할 수 없습니다.

물리적 디바이스와 프로바이더 수용은 웹 로컬 골든 패스와 분리되어 있습니다. 각 릴리스 대상에 대해 명시적으로 추적하세요.


설정을 계속하려면 [모바일 앱 실행](https://supastack.dev/ko/docs/mobile/local-setup.md) 가이드를 읽어보세요.


## 다음

[모바일 앱 5분 시작](https://supastack.dev/ko/docs/mobile/ship-in-5-minutes.md)