React

Getting started

Boilerplate-React 시작하기

소스 다운로드

git.dosystem.kr/confy/confy-app 다운로드. develop 브랜치가 최신 브랜치 입니다.

confy-app/apps/boilerplate-react 이하 폴더가 소스 코드 대상입니다.

confy-app/ # 프로젝트 루트
├── apps/ # 애플리케이션 디렉토리
│ ├── boilerplate-next/ # Next.js 애플리케이션 <-- 사용안할 경우 삭제
│ │
│ └── boilerplate-react/ # React 애플리케이션 <-- 실제 이용하는 것
│ └── ... # React 관련 설정 및 코드
├── packages/ # 공유 패키지
│ └── ... # 공유 컴포넌트, 유틸리티 등
├── .turbo/ # Turborepo 캐시
├── node_modules/ # 의존성 패키지
├── pnpm-workspace.yaml # pnpm 워크스페이스 설정
├── turbo.json # Turborepo 설정
└── ... # 기타 설정 파일들

pnpm 설치

node package 관리를 위해 pnpm을 설치합니다.

# 시스템 전역 설치
npm install -g pnpm
# 버전확인 - 10 버전 이상 권장 (최신버전)
pnpm --version

빌드 / 실행

모든 명령어는 pnpm 패키지 매니저를 사용하여 실행해야 합니다.

  • 프로젝트는 Vite를 빌드 도구로 사용하며, TypeScript와 React를 지원합니다.
  • 개발 서버는 기본적으로 http://localhost:5173 에서 실행됩니다.
...
"scripts": {
"dev": "vite --mode development",
"build": "tsc -b && vite build",
"lint": "eslint .",
"preview": "vite preview",
"clean": "rm -rf node_modules && rm -rf dist"
},

개발 서버 실행

pnpm dev

vite --mode development 명령어를 실행하여 개발 서버를 시작합니다.
개발 모드에서는 핫 리로딩(Hot Module Replacement)이 활성화되어 코드 변경 시 자동으로 브라우저가 갱신됩니다.

프로덕션 빌드

pnpm build

tsc -b로 TypeScript 컴파일을 수행한 후 vite build로 프로덕션용 빌드를 생성합니다. 결과물은 dist 디렉토리에 생성됩니다.

정적 코드 분석

pnpm lint

eslint . 명령어로 프로젝트 전체의 코드 품질을 검사합니다.
ESLint 규칙에 따라 코드 스타일과 잠재적인 문제를 체크합니다.

모듈 초기화

pnpm clean

node_modulesdist 디렉토리를 삭제하여 프로젝트를 초기 상태로 정리합니다.
의존성 문제가 있을 때나 디스크 공간 확보가 필요할 때 사용합니다.

PreviousOverview