Skip to content

About

BETA 앱 프론트엔드 레포지토리입니다.

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

📝 Introduction

BETA-Client는 BETA 서비스의 사용자용 모바일 앱(React Native) 클라이언트입니다.

  • Expo 기반으로 개발/빌드되며, expo-dev-client를 사용해 네이티브 모듈(Firebase, Vision Camera, 소셜 로그인 등)을 포함한 개발 흐름을 지원합니다.
  • 화면 전환은 React Navigation으로 구성되어 있고, 서버 상태는 TanStack Query, 앱 상태는 Zustand를 중심으로 관리합니다.
  • API Base URL 및 소셜 로그인 설정은 **환경변수 → app.config.js의 expo.extra**로 주입됩니다.

🛠️ Tech Stack

Category Stack
Core React Native Expo Expo Updates
Navigation / State React Navigation TanStack Query Zustand
Styling NativeWind
Networking Axios NetInfo
Push / Native FCM Vision Camera
Social Login Kakao Naver Apple

🧩 Project Structure

주요 디렉터리는 아래 구조로 관리합니다.

Path Description
src/app/ 앱 엔트리, Provider 구성, 네비게이션 루트
src/features/ 도메인/화면 단위 기능 모듈 (auth, home, community, search, profile, photoBooth 등)
src/shared/ 공통 컴포넌트/유틸/스토어/서비스(API, 세션, 푸시 등)
assets/ 앱 아이콘/스플래시 등 정적 리소스

🏛️ Architecture

App Bootstrap Flow

앱 시작 시 세션을 준비한 뒤, 스플래시 종료 시점에 Auth 또는 Main으로 분기합니다.

flowchart TD
  A[App 시작] --> B[bootstrapSession]
  B --> C[SplashScreen]
  C -->|exit complete| D{destination}
  D -->|main| E[MainTabNavigator]
  D -->|auth| F[AuthStack]
Loading

API Base URL Resolution

API baseURL은 TestFlight/런타임 환경 차이를 고려해 아래 우선순위로 결정됩니다.

  1. Constants.expoConfig.extra.backendUrl (권장)
  2. process.env.EXPO_PUBLIC_BACKEND_URL
  3. fallback: https://beta-app.kr

관련 구현은 src/shared/libs/api.js에서 관리합니다.


▶️ Getting Started

Install

npm install

Run (Expo)

npm run start

Run (Dev Client)

네이티브 모듈이 포함되어 있으므로, 디바이스/시뮬레이터에서 dev-client로 실행합니다.

npm run ios
npm run android

🚀 Build & Release (EAS)

본 프로젝트는 eas.json 기준으로 development / preview / production 프로파일을 운영합니다.

Profile Purpose Channel
development 내부 개발 빌드 (dev-client) development
preview QA/검증용 내부 배포 preview
production 프로덕션 배포 production

예시:

eas build --profile development --platform ios
eas build --profile preview --platform android
eas build --profile production --platform ios

📌 Notes

  • iOS Push/FCM 관련해서 aps-environment 값은 EAS_BUILD_PROFILE에 따라 자동 설정되며, 네이티브 설정 변경이 필요한 경우 prebuild 후 재빌드가 필요합니다. (app.config.js 참고)

About

BETA 앱 프론트엔드 레포지토리입니다.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages