RideOn FE 레포지토리입니다.
git clone https://github.com/2025-All4Land-RideOn/FE.git
cd FE
npm install
npm run devFE/
┣ .github/ # GitHub 관련 설정
┃ ┣ ISSUE_TEMPLATE/ # 이슈 템플릿 폴더
┃ ┣ workflows/ # GitHub Actions 워크플로우 정의
┃ ┗ PULL_REQUEST_TEMPLATE.md # PR 템플릿
┣ dist/ # Vite 빌드 결과물 (자동 생성)
┣ node_modules/ # 설치된 의존성 모듈
┣ public/ # 정적 리소스 (favicon, svg, robots.txt 등)
┣ src/ # 주요 소스 코드 디렉토리
┃ ┣ apis/ # API 호출 및 axios 클라이언트
┃ ┣ assets/ # 이미지, 아이콘 등 정적 리소스
┃ ┣ components/ # 재사용 가능한 UI 컴포넌트
┃ ┣ data/ # 더미 데이터 및 mock JSON
┃ ┣ hooks/ # 커스텀 훅 (useFetch, useMap 등)
┃ ┣ pages/ # 페이지 단위 화면 컴포넌트
┃ ┣ styles/ # 전역 및 공통 스타일 (CSS, Tailwind 확장)
┃ ┣ utils/ # 유틸리티 함수 (mapMarkers, helpers 등)
┃ ┣ App.jsx # 루트 컴포넌트 (라우팅 포함)
┃ ┗ main.jsx # React 진입점 (ReactDOM.createRoot)
┣ .gitignore # Git 무시 규칙 파일
┣ eslint.config.js # ESLint 코드 스타일 설정
┣ index.html # HTML 엔트리 포인트 (Vite 진입 파일)
┣ package.json # 프로젝트 메타 및 의존성 정의
┣ package-lock.json # npm 버전 잠금 파일
┣ postcss.config.cjs # PostCSS 설정 (Tailwind 플러그인 포함)
┣ tailwind.config.js # TailwindCSS 설정
┣ vercel.json # Vercel 배포 설정
┣ vite.config.js # Vite 빌드 및 개발 서버 설정
┗ README.md # 프론트엔드 협업 문서
브랜치 전략은 Git Flow를 단순화한 구조로, main은 배포용 안정 브랜치, develop은 통합 브랜치로 사용합니다.
기능·수정·작업 단위(feature/*, refactor/* 등)의 브랜치는 develop에서 분기합니다.
| Prefix | 설명 | 예시 |
|---|---|---|
| feature/ | 새로운 기능 개발 | feature/#12-login |
| refactor/ | 코드 리팩토링 | refactor/#20-post-ref |
| chore/ | 설정/빌드/패키지 | chore/#6-eslint |
| docs/ | 문서 수정 | docs/#7-readme |
| style/ | CSS, 코드 스타일 수정 | style/#15-theme |
| test/ | 테스트 코드 | test/#25-api-test |
| Type | 설명 | 예시 |
|---|---|---|
| feat | 기능 추가 | feat: 로그인 페이지 UI 추가 |
| fix | 버그 수정 | fix: 헤더 네비게이션 링크 오류 수정 |
| hotfix | 긴급 버그 수정 | hotfix: 배포 후 로그인 불가 문제 해결 |
| chore | 설정/빌드 관련 | chore: ESLint 및 Prettier 설정 추가 |
| docs | 문서 수정 | docs: README 브랜치 전략 섹션 작성 |
| style | 코드 스타일 수정 | style: 글로벌 테마 색상 변경 |
| refactor | 코드 리팩토링 | refactor: 게시글 리스트 렌더링 최적화 |
| test | 테스트 추가/수정 | test: 로그인 API 테스트 추가 |
| remove | 불필요 코드/파일 삭제 | remove: 미사용 컴포넌트 삭제 |
| merge | 브랜치 병합 | merge: develop 브랜치 최신 변경사항 현재 브랜치에 병합 |
| 단계 | 설명 |
|---|---|
| 1 | 이슈 생성 |
| 2 | 브랜치 생성 (prefix/#이슈번호-작업명) → develop 기준 |
| 3 | 작업 후 커밋 |
| 4 | Pull Request 생성 → 코드 리뷰 |
| 5 | 리뷰 승인 후 develop 에 머지 |