- CLAUDE.md: React/TypeScript/Vite 프로젝트 가이드 - .claude/settings.json: npm/Node.js 빌드 도구 권한 설정 - .claude/rules/: TypeScript/React 코드 스타일, 네이밍, 테스트 규칙 - .githooks/pre-commit: TypeScript 타입체크 + ESLint 검증 - .npmrc: Nexus npm 프록시 레지스트리 - .prettierrc: 코드 포맷팅 설정 - .node-version: Node.js 버전 고정
1.5 KiB
1.5 KiB
프로젝트 개요
- 타입: React + TypeScript + Vite
- Node.js:
.node-version참조 - 패키지 매니저: npm
- 빌드 도구: Vite
빌드 및 실행
# 의존성 설치
npm install
# 개발 서버
npm run dev
# 빌드
npm run build
# 테스트
npm run test
# 린트
npm run lint
# 포맷팅
npm run format
프로젝트 구조
src/
├── assets/ # 정적 리소스 (이미지, 폰트 등)
├── components/ # 공통 UI 컴포넌트
│ ├── common/ # 범용 컴포넌트 (Button, Input 등)
│ └── layout/ # 레이아웃 컴포넌트 (Header, Sidebar 등)
├── hooks/ # 커스텀 훅
├── pages/ # 페이지 컴포넌트 (라우팅 단위)
├── services/ # API 호출 로직
├── store/ # 상태 관리 (Context, Zustand 등)
├── types/ # TypeScript 타입 정의
├── utils/ # 유틸리티 함수
├── App.tsx
└── main.tsx
팀 규칙
- 코드 스타일:
.claude/rules/code-style.md참조 - 네이밍 규칙:
.claude/rules/naming.md참조 - 테스트 규칙:
.claude/rules/testing.md참조 - Git 워크플로우:
.claude/rules/git-workflow.md참조 - 팀 정책:
.claude/rules/team-policy.md참조
의존성 관리
- Nexus 프록시 레포지토리를 통해 npm 패키지 관리 (
.npmrc) - 새 의존성 추가:
npm install 패키지명 - devDependency:
npm install -D 패키지명