@daawoonkim/create-arch-app 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 create-arch-app contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,267 @@
+# create-arch-app
+
+DDD, Clean Architecture, Atomic Design을 지원하는 대화형 React/Next.js 프로젝트 생성 CLI 도구
+
+## 특징
+
+✨ **4가지 아키텍처 패턴 지원**
+- DDD (Domain-Driven Design)
+- Clean Architecture  
+- Atomic Design
+- Default (기본 구조)
+
+🚀 **프레임워크 선택**
+- React (with Vite)
+- Next.js (App Router / Pages Router)
+
+💎 **TypeScript 기본 포함**
+
+🎨 **스타일링 옵션**
+- Tailwind CSS
+- CSS Modules
+
+📦 **선택 가능한 라이브러리**
+- 상태관리: Zustand, Context API
+- 폼: React Hook Form
+- 테스팅: Vitest + Testing Library
+
+## 설치 및 사용법
+
+### npx로 즉시 사용 (권장)
+
+```bash
+# 새 디렉토리에 프로젝트 생성
+npx @daawoonkim/create-arch-app my-app
+
+# 또는 현재 디렉토리에 직접 생성
+npx @daawoonkim/create-arch-app .
+```
+
+### 전역 설치
+
+```bash
+npm install -g @daawoonkim/create-arch-app
+
+# 새 디렉토리에 프로젝트 생성
+create-arch-app my-app
+
+# 현재 디렉토리에 직접 생성
+create-arch-app .
+```
+
+> **참고**: 현재 디렉토리(`.`)를 사용하려면 디렉토리가 비어있어야 합니다.
+
+### 대화형 프롬프트
+
+CLI를 실행하면 다음 질문들에 답하게 됩니다:
+
+1. **프레임워크 선택**: React 또는 Next.js
+2. **Next.js 버전 선택** (Next.js만 해당): Latest (권장), 15.x, 14.x, 13.x
+3. **라우터 선택** (Next.js만 해당): App Router (권장) 또는 Pages Router
+4. **아키텍처 패턴**: DDD, Clean, Atomic, Default
+5. **스타일링 도구**: Tailwind CSS 또는 CSS Modules
+6. **상태관리**: Zustand, Context API, None
+7. **폼 라이브러리**: React Hook Form 또는 None
+8. **테스팅 도구**: Vitest + Testing Library 포함 여부
+
+## 사용 예시
+
+```bash
+npx @daawoonkim/create-arch-app my-enterprise-app
+
+# 대화형 프롬프트
+? 프레임워크를 선택하세요: Next.js
+? Next.js 버전을 선택하세요: Latest (최신 버전, 권장)
+? Next.js 라우터를 선택하세요: App Router (권장)
+? 아키텍처 패턴을 선택하세요: DDD (Domain-Driven Design)
+? 스타일링 도구를 선택하세요: Tailwind CSS
+? 상태관리 라이브러리를 선택하세요: Zustand
+? 폼 라이브러리를 선택하세요: React Hook Form
+? 테스팅 도구를 포함하시겠습니까? Yes
+
+✨ 프로젝트 생성 중...
+📦 TypeScript 프로젝트로 설정됩니다 (기본값)
+🚀 Next.js App Router 사용
+✅ 프로젝트 생성 완료!
+
+🎉 프로젝트가 성공적으로 생성되었습니다!
+
+다음 명령어로 시작하세요:
+  cd my-enterprise-app
+  npm install
+  npm run dev
+```
+
+## 아키텍처 패턴 설명
+
+### DDD (Domain-Driven Design)
+
+엔터프라이즈급 애플리케이션에 적합한 패턴입니다.
+
+```
+domain/          # 비즈니스 엔티티와 로직
+  ├── entities/
+  ├── repositories/
+  └── services/
+application/     # 유스케이스
+  ├── usecases/
+  └── ports/
+infrastructure/  # 외부 서비스 통합
+  ├── api/
+  └── persistence/
+presentation/    # UI 컴포넌트
+  ├── components/
+  └── pages/
+```
+
+### Clean Architecture
+
+의존성 규칙과 레이어 분리에 중점을 둔 패턴입니다.
+
+```
+core/           # 비즈니스 로직
+  ├── entities/
+  ├── usecases/
+  └── interfaces/
+features/       # 기능별 모듈
+  └── [feature]/
+      ├── domain/
+      ├── data/
+      └── presentation/
+shared/         # 공통 컴포넌트
+  ├── components/
+  └── utils/
+```
+
+### Atomic Design
+
+UI 컴포넌트 중심 개발에 최적화된 패턴입니다.
+
+```
+components/
+  ├── atoms/      # 가장 작은 UI 단위
+  ├── molecules/  # atoms 조합
+  ├── organisms/  # molecules 조합
+  ├── templates/  # 페이지 레이아웃
+  └── pages/      # 실제 페이지
+hooks/
+utils/
+```
+
+### Default
+
+빠른 시작을 원하는 개발자를 위한 기본 구조입니다.
+
+```
+components/
+hooks/
+pages/ (또는 app/)
+utils/
+styles/
+types/
+```
+
+## 생성되는 파일 구조
+
+### React 프로젝트
+
+```
+my-app/
+├── src/
+│   ├── [architecture folders]
+│   ├── App.tsx
+│   ├── main.tsx
+│   └── index.css
+├── index.html
+├── vite.config.ts
+├── tsconfig.json
+├── package.json
+└── README.md
+```
+
+### Next.js 프로젝트 (App Router)
+
+```
+my-app/
+├── app/
+│   ├── layout.tsx
+│   ├── page.tsx
+│   └── globals.css
+├── [architecture folders]
+├── next.config.js
+├── tsconfig.json
+├── package.json
+└── README.md
+```
+
+### Next.js 프로젝트 (Pages Router)
+
+```
+my-app/
+├── pages/
+│   ├── _app.tsx
+│   ├── _document.tsx
+│   └── index.tsx
+├── styles/
+│   └── globals.css
+├── [architecture folders]
+├── next.config.js
+├── tsconfig.json
+├── package.json
+└── README.md
+```
+
+## 요구 사항
+
+- Node.js 18.0.0 이상
+
+## 개발
+
+이 프로젝트를 로컬에서 개발하려면:
+
+```bash
+# 저장소 클론
+git clone git@github.com:hec8897/create-arch-app.git
+cd create-arch-app
+
+# 의존성 설치
+npm install
+
+# TypeScript 컴파일
+npm run build
+
+# 로컬 링크 생성
+npm link
+
+# 테스트
+cd ~/test-project
+create-arch-app my-test-app
+```
+
+## 로드맵
+
+- [ ] 추가 아키텍처 패턴 (Feature-Sliced Design, Hexagonal Architecture)
+- [ ] UI 라이브러리 통합 (shadcn/ui, MUI, Ant Design)
+- [ ] 추가 상태관리 옵션 (Redux Toolkit, Jotai, Recoil)
+- [ ] 인증 통합 (NextAuth, Supabase)
+- [ ] ORM 통합 (Prisma, Drizzle)
+- [ ] 컴포넌트 생성기
+- [ ] CI/CD 설정 자동화
+- [ ] Docker 설정 포함
+- [ ] Monorepo 지원 (Turborepo)
+
+## 기여하기
+
+버그 리포트, 기능 제안, PR 모두 환영합니다!
+
+## 라이선스
+
+MIT
+
+## 작성자
+
+daawoonkim
+
+## 참고
+
+이 프로젝트는 현대적인 프론트엔드 개발 모범 사례와 다양한 아키텍처 패턴을 기반으로 합니다.

package/TESTING.md

@@ -0,0 +1,224 @@
+# 테스트 가이드
+
+## 로컬 테스트 방법
+
+### 1. 준비
+
+```bash
+cd /Users/dawoon/create-arch-app
+npm run build
+npm link
+```
+
+### 2. 테스트 디렉토리 생성
+
+```bash
+mkdir -p ~/test-create-arch-app
+cd ~/test-create-arch-app
+```
+
+### 3. 주요 조합 테스트
+
+다음 조합들을 테스트하여 정상 작동을 확인합니다:
+
+#### 테스트 0: 현재 디렉토리에 생성 (`.` 옵션)
+
+```bash
+mkdir test-current-dir && cd test-current-dir
+create-arch-app .
+
+# 프롬프트 선택:
+# - Framework: React (with Vite)
+# - Architecture: Default
+# - Styling: Tailwind CSS
+# - State: None
+# - Form: None
+# - Testing: No
+
+npm install
+npm run dev
+
+# ✅ 현재 디렉토리에 직접 파일들이 생성되었는지 확인
+# ✅ 불필요한 중첩 폴더가 없는지 확인
+cd ..
+```
+
+#### 테스트 1: React + DDD + Tailwind
+
+```bash
+create-arch-app test-react-ddd
+
+# 프롬프트 선택:
+# - Framework: React (with Vite)
+# - Architecture: DDD
+# - Styling: Tailwind CSS
+# - State: Zustand
+# - Form: React Hook Form
+# - Testing: Yes
+
+cd test-react-ddd
+npm install
+npm run dev
+
+# ✅ 개발 서버가 정상 실행되는지 확인
+# ✅ http://localhost:5173 접속하여 화면 확인
+```
+
+#### 테스트 2: Next.js + App Router + Clean Architecture
+
+```bash
+create-arch-app test-nextjs-app-clean
+
+# 프롬프트 선택:
+# - Framework: Next.js
+# - Next.js Version: Latest (최신 버전, 권장)
+# - Router: App Router (권장)
+# - Architecture: Clean Architecture
+# - Styling: Tailwind CSS
+# - State: Context API
+# - Form: None
+# - Testing: Yes
+
+cd test-nextjs-app-clean
+npm install
+npm run dev
+
+# ✅ 개발 서버가 정상 실행되는지 확인
+# ✅ http://localhost:3000 접속하여 화면 확인
+```
+
+#### 테스트 3: Next.js + Pages Router + Atomic Design
+
+```bash
+create-arch-app test-nextjs-pages-atomic
+
+# 프롬프트 선택:
+# - Framework: Next.js
+# - Next.js Version: 14.x
+# - Router: Pages Router
+# - Architecture: Atomic Design
+# - Styling: CSS Modules
+# - State: None
+# - Form: None
+# - Testing: No
+
+cd test-nextjs-pages-atomic
+npm install
+npm run dev
+
+# ✅ 개발 서버가 정상 실행되는지 확인
+# ✅ http://localhost:3000 접속하여 화면 확인
+```
+
+#### 테스트 4: React + Default + CSS Modules
+
+```bash
+create-arch-app test-react-default
+
+# 프롬프트 선택:
+# - Framework: React (with Vite)
+# - Architecture: Default
+# - Styling: CSS Modules
+# - State: None
+# - Form: None
+# - Testing: No
+
+cd test-react-default
+npm install
+npm run dev
+
+# ✅ 개발 서버가 정상 실행되는지 확인
+# ✅ http://localhost:5173 접속하여 화면 확인
+```
+
+### 4. 체크리스트
+
+각 테스트 프로젝트에서 다음 사항들을 확인합니다:
+
+- [ ] 프로젝트 폴더가 정상 생성됨
+- [ ] package.json에 올바른 의존성이 포함됨
+- [ ] tsconfig.json이 생성됨
+- [ ] 선택한 아키텍처에 맞는 폴더 구조가 생성됨
+- [ ] `npm install`이 오류 없이 완료됨
+- [ ] TypeScript 컴파일 오류가 없음
+- [ ] `npm run dev`로 개발 서버가 실행됨
+- [ ] 브라우저에서 화면이 정상 표시됨
+- [ ] README.md에 프로젝트 정보가 올바르게 표시됨
+- [ ] Tailwind CSS 선택 시 스타일이 적용됨
+- [ ] 테스팅 옵션 선택 시 테스트 설정이 포함됨
+
+### 5. 빌드 테스트
+
+```bash
+npm run build
+```
+
+- [ ] 프로덕션 빌드가 오류 없이 완료됨
+- [ ] 빌드 결과물이 생성됨 (React: dist/, Next.js: .next/)
+
+### 6. 테스트 후 정리
+
+```bash
+cd ~/test-create-arch-app
+rm -rf test-*
+```
+
+## 자동화된 테스트 (향후 추가)
+
+향후 다음과 같은 자동화된 테스트를 추가할 예정입니다:
+
+- E2E 테스트 (Playwright)
+- 스냅샷 테스트
+- 생성된 프로젝트의 린트 검사
+- 모든 조합에 대한 자동 생성 및 빌드 테스트
+
+## 문제 해결
+
+### 문제: npm link 후 명령어를 찾을 수 없음
+
+```bash
+npm unlink -g create-arch-app
+cd /Users/dawoon/create-arch-app
+npm link
+```
+
+### 문제: 포트가 이미 사용 중
+
+다른 포트로 실행:
+
+```bash
+# React (Vite)
+npm run dev -- --port 5174
+
+# Next.js
+npm run dev -- -p 3001
+```
+
+### 문제: TypeScript 오류
+
+생성된 프로젝트에서:
+
+```bash
+# node_modules 삭제 후 재설치
+rm -rf node_modules package-lock.json
+npm install
+```
+
+## 테스트 결과 보고
+
+테스트 중 발견한 문제는 다음 정보와 함께 보고해주세요:
+
+1. 선택한 옵션 조합
+2. 오류 메시지
+3. 실행 환경 (OS, Node 버전)
+4. 재현 방법
+
+## 성능 테스트
+
+프로젝트 생성 시간을 측정합니다:
+
+```bash
+time create-arch-app test-perf
+```
+
+- 목표: 10초 이내 (의존성 설치 제외)

package/bin/cli.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+
+// ES Module을 사용하므로 dist/index.js를 import
+import '../dist/index.js';