create-square-app

Square 사내 프론트엔드 프로젝트를 만드는 템플릿 CLI입니다.

npx create-square-app my-app
cd my-app
pnpm dev

포함된 기본 구조

• Next.js 16 + React 19 + TypeScript
• WDS, Tailwind, React Query, TanStack Form, Zustand, Day.js, Zod
• app/shared/features 중심의 최소 폴더 구조

기본 패키지 사용 기준

• React Query: 서버 상태, 캐시, refetch가 필요한 API 상태
• TanStack Form: 복잡한 폼 상태와 validation 흐름
• Zustand: 여러 컴포넌트가 공유하는 클라이언트/UI 상태
• Day.js: 날짜 포맷, 날짜 계산, immutable date manipulation
• Zod: API 응답, 폼 값, 도메인 입력값 검증

패키지별 상세 사용 패턴은 생성된 프로젝트의 docs/package-patterns.md를 확인하세요.

환경 변수

기본 템플릿에서 요구하는 환경 변수는 없습니다. 프로젝트별 설정이 필요하면 생성된 프로젝트의 .env.example에 추가하세요.

필요한 환경

• Node.js 20 LTS 이상
• pnpm