네이티브 인증

설치 및 설정

어떤 단계를 시작하기 전에 시작하기 전에 및 터미널 기본 사항을 읽어보세요. 이 지침에서는 VS Code에서 전체 supastack 단일 저장소를 열었다고 가정합니다. 해당 루트 package.json은 저장소 루트를 표시합니다. pnpm 명령에서 작업 영역 패키지는 앱 또는 공유 코드 폴더입니다. 제품에서 작업공간은 팀의 데이터 컨테이너이자 보안 경계입니다. corepack pnpm --filter ... 명령이 해당 루트에서 실행되는 동안 monorepo에서 하나의 패키지를 선택합니다. 동기화된 모바일 또는 데스크톱 폴더만 열었다면 웹 백엔드, Docker 설정 또는 루트 스크립트가 포함되지 않습니다. 이 모노 저장소 또는 연결 가능한 호스팅 서버에서 백엔드를 실행하고 플랫폼 폴더의 자체 스크립트를 사용하세요. 환경 변수는 로컬 .env 파일이나 호스팅 대시보드에 저장된 명명된 설정입니다. 관련 앱을 변경한 후 다시 시작하고, NEXT_PUBLIC_ 및 EXPO_PUBLIC_ 값에서 서버 비밀을 유지하세요.

1. VS Code에서 apps/mobile/src/auth/client.ts 및 apps/mobile/src/auth/mobile-auth-configuration.ts를 열어 기존 로그인 흐름을 찾습니다.

2. EXPO_PUBLIC_API_URL 및 EXPO_PUBLIC_APP_SCHEME를 apps/mobile/.env.local에 넣고 웹 서버가 apps/web/.env.local.에 자체 설정을 가지고 있는지 확인하십시오.

3. 루트에서 corepack pnpm --filter @supastack/web dev를 사용하여 웹을 시작한 다음 다른 터미널에서 corepack pnpm --filter @supastack/mobile start를 사용하여 Expo를 시작합니다. 예상: 테스트 로그인을 하면 브라우저가 열리고 모바일 앱으로 돌아갑니다. 실제 전화기에서는 API에 컴퓨터의 연결 가능한 Wi-Fi/LAN 주소를 사용합니다. Phone-localhost는 전화 자체를 의미합니다.

모바일 앱은 Better Auth Expo 통합과 네이티브 보안 저장소를 사용합니다. API 오리진과 앱 스킴은 네이티브 구성 및 인증 서버의 허용된 복귀 플로와 일치해야 합니다.

EXPO_PUBLIC_API_URL=https://your-api.example
EXPO_PUBLIC_APP_SCHEME=supastack

복사 명령

설명을 따라 명령이 실행되는 폴더를 확인하세요. 두 개의 터미널에 레이블이 지정되어 있으면 두 개의 터미널 창을 열고 두 번째 명령을 사용하는 동안 첫 번째 명령을 계속 실행하세요.

# Terminal 1 — Web API (from the monorepo root):
corepack pnpm --filter @supastack/web dev

# Terminal 2 — Expo app (from the monorepo root):
corepack pnpm --filter @supastack/mobile start

구현 워크플로

웹 쿠키 가정을 모바일에 복사하는 대신 기존 네이티브 인증 클라이언트를 따르세요. 구성된 브라우저 플로를 통해 프로바이더 인증을 열고, 그 콜백을 처리한 다음, 보호된 액션을 표시하기 전에 인증된 세션을 해석하세요.

취소된 로그인과 성공한 로그인을 명확히 구분하세요. 멤버는 설정 → 보안에서 생체 인식 앱 잠금(apps/mobile/src/security/app-lock.ts의 Face ID, Touch ID 또는 지문)을 활성화하여 포그라운드 복귀를 보호할 수 있습니다. 로그아웃 시 이전 사용자의 로컬 표시 상태와 워크스페이스 범위의 오프라인 읽기 캐시(apps/mobile/src/offline/)를 지우고, 서버 세션이 더 이상 보호된 작업을 수행할 수 없는지 확인하세요.

검증 및 문제 해결

로그인하면 브라우저가 열리지만 앱으로 돌아가지 않는 경우 EXPO_PUBLIC_APP_SCHEME가 apps/mobile/app.config.ts.의 체계와 일치하는지 확인하세요. 앱이 서버에 연결할 수 없는 경우 localhost를 컴퓨터의 LAN 주소로 바꾸고 두 장치가 모두 동일한 네트워크를 사용하는지 확인한 다음 apps/mobile/.env.local.를 편집한 후 Expo를 다시 시작하세요. Expo Go는 UI 미리보기입니다. 기본 구매 승인에는 EAS 개발 빌드가 필요합니다.

대상 빌드에서 콜드 스타트 콜백, 실행 중인 앱으로의 복귀, 취소된 로그인, 만료된 세션을 실행하세요. 브라우저가 돌아왔는데 앱이 로그아웃 상태로 남으면 프로바이더 구성을 바꾸기 전에 스킴 일치와 API 도달 가능성을 검사하세요.