README.md

OneStep Frontend 🚀

큰 목표를 작은 걸음으로! OneStep의 프론트엔드 레포지토리입니다.

📱 프로젝트 소개

OneStep은 사용자가 목표를 작은 단계로 나누어 꾸준히 실천할 수 있도록 돕는 투두 관리 서비스입니다. React Native와 Expo를 기반으로 구축된 크로스 플랫폼 모바일 애플리케이션입니다.

플레이스토어 앱스토어

🛠 기술 스택

• 프레임워크: React Native, Expo
• 상태 관리: Zustand
• API 통신: React Query, Axios
• 인증: Firebase Authentication
• 모니터링: Firebase Analytics, Sentry
• UI 라이브러리: UI Kitten, React Native Elements
• 다국어: i18next
• 테스트: Maestro, Jest
• 개발 도구: TypeScript, ESLint, Prettier
• 배포: GitHub Actions, EAS Build

📦 프로젝트 구조

frontend/
├── app/           # Expo Router 기반 화면 구성
├── components/    # 재사용 가능한 컴포넌트
├── contexts/      # React Context 정의
├── hooks/        # Custom React Hooks
├── utils/        # 유틸리티 함수
├── theme/        # UI 테마 설정
├── locales/      # 다국어 지원 리소스
├── types/        # TypeScript 타입 정의
└── tests/        # 테스트 파일

🚀 시작하기

설치 및 실행

1. 레포지토리 클론

git clone https://github.com/your-repo/frontend.git
cd frontend

2. 의존성 설치

npm install

3. 개발 환경 실행

# 로컬 개발
npm run start:local

# 개발 서버
npm run start:dev

# 스테이징 서버
npm run start:stage

# 프로덕션 서버
npm run start:prod

플랫폼별 실행

# iOS
npm run ios:local
npm run ios:dev
npm run ios:stage
npm run ios:prod

# Android
npm run android:local
npm run android:dev
npm run android:stage
npm run android:prod

🧪 테스트

# 단위 테스트 실행
npm run test

# E2E 테스트 실행 (Android)
npm run e2e-test:android

# E2E 테스트 실행 (iOS)
npm run e2e-test:ios

📝 코드 품질 관리

# 린트 검사 및 수정
npm run lint

# 타입 체크
npm run type-check

# 코드 포맷팅 검사
npm run prettier-check

🔑 환경 변수 설정

프로젝트 루트에 다음 환경 변수 파일들을 설정해야 합니다:

• .env.local: 로컬 개발 환경
• .env: 개발 환경
• .env.e2e: E2E 테스트 환경

📞 문의

프로젝트에 대한 문의사항은 아래 이메일로 연락주세요:

📧 szonestep@gmail.com