Harucut Frontend Workspace

Harucut 프론트엔드 워크스페이스.

• 웹 앱: apps/web
• 모바일 앱: apps/mobile
• 루트: 공통 문서, 워크스페이스 검증 스크립트, GitHub 설정

구조

• apps/web: Next.js App Router 기반 웹 앱
• apps/mobile: Expo Router 기반 iOS/Android 앱
• docs/: 서비스 흐름, 인증 라우팅, 모바일 설계, QA 체크리스트, ADR
• scripts/: 검증 스크립트
• .github/: 워크플로와 저장소 자동화 설정

시작

pnpm install

웹 개발 서버:

pnpm dev:web

모바일 개발 서버:

pnpm dev:mobile

주요 스크립트

• pnpm dev:web
• pnpm build:web
• pnpm test:web
• pnpm lint:mobile
• pnpm typecheck:mobile
• pnpm verify:web
• pnpm verify:mobile
• pnpm verify:standard

라우트 개요

공개 라우트

• /
• /login
• /signup
• /forgot-password

보호 라우트

• /home
• /shoot/*
• /upload/*
• /theme/*
• /history
• /mypage

보호 라우트는 apps/web/proxy.ts에서 처리한다.
비인증 상태에서 접근하면 /login?redirectTo=<원래 경로>로 이동한다.

문서

• 라우트 플로우: docs/route-flows.md
• 인증 및 리다이렉트: docs/auth-routing.md
• 모바일 앱 설계: docs/mobile-app-blueprint.md
• 작업 규칙: AGENTS.md
• 기여 가이드: CONTRIBUTING.md

브랜치 정책

• 시작 브랜치: develop
• 작업 브랜치: issue/<number>-<slug>
• 승격 경로: develop -> main
• main, develop 직접 commit/push 금지