대정유통의 홍게 상품을 판매하는 커머스 웹사이트입니다. React와 TypeScript를 기반으로 상품 탐색부터 주문까지 확장할 수 있도록 개발 환경과 역할별 디렉터리 구조를 구성했습니다.
- React 19
- TypeScript 6
- Vite 8
- Tailwind CSS 4
@tailwindcss/vite
- React Router 7: 클라이언트 라우팅
- Zustand 5: 클라이언트 상태 관리
- TanStack Query 5: 서버 상태 및 비동기 데이터 관리
- Axios: HTTP 요청
- Lucide: 아이콘
- ESLint
- TypeScript ESLint
- React Hooks ESLint plugin
- React Refresh ESLint plugin
- Node.js 20 이상 권장
- npm
npm installnpm run dev개발 서버가 실행되면 터미널에 표시된 로컬 주소로 접속합니다.
| 명령어 | 설명 |
|---|---|
npm run dev |
Vite 개발 서버 실행 및 HMR 제공 |
npm run build |
TypeScript 검사 후 프로덕션 빌드 |
npm run lint |
ESLint 정적 검사 |
npm run preview |
프로덕션 빌드 결과 로컬 미리보기 |
.
├── public/ # 정적 파일
├── src/
│ ├── app/ # 애플리케이션 진입 및 전역 설정
│ ├── assets/ # 이미지, SVG 등 번들 대상 에셋
│ ├── components/ # 여러 기능에서 재사용하는 UI 컴포넌트
│ ├── features/ # 도메인 또는 기능 단위 모듈
│ ├── hooks/ # 공통 React 커스텀 훅
│ ├── layouts/ # 페이지 레이아웃
│ ├── lib/ # 외부 라이브러리 초기화 및 공통 설정
│ ├── pages/ # 라우트 단위 페이지
│ ├── services/ # API 요청 및 외부 서비스 연동
│ ├── stores/ # Zustand 전역 상태
│ ├── types/ # 공통 TypeScript 타입
│ ├── utils/ # 공통 유틸리티 함수
│ ├── App.css # 기본 화면 스타일
│ ├── App.tsx # 현재 애플리케이션 화면
│ ├── index.css # 전역 스타일 및 Tailwind CSS 진입점
│ └── main.tsx # React 애플리케이션 진입점
├── eslint.config.js # ESLint flat config
├── vite.config.ts # Vite 및 Tailwind 플러그인 설정
├── tsconfig.json # TypeScript 프로젝트 설정
├── tsconfig.app.json # 앱 소스 TypeScript 설정
├── tsconfig.node.json # Vite 설정 TypeScript 설정
└── package.json # 의존성 및 npm 스크립트
커밋 전 아래 명령어를 실행합니다.
npm run lint
npm run build기본 개발 흐름은 다음과 같이 운영합니다.
feature/* 또는 fix/* -> develop -> main
main: 운영 배포 기준 브랜치develop: 개발 통합 브랜치feature/*: 신규 기능 개발fix/*: 버그 수정