template-react-ts/CLAUDE.md

프로젝트 개요

• 타입: 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 패키지명