RideOn FE 레포지토리입니다.
git clone https://github.com/2025-All4Land-RideOn/FE.git
cd FE
npm install
npm run dev FE/
┣ .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 # 프론트엔드 협업 문서
3. 🌿 Branch Strategy & Naming Convention 브랜치 전략은 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 에 머지