@daawoonkim/create-arch-app 0.2.0 → 0.2.1

package/CHANGELOG.ko.md

@@ -0,0 +1,72 @@
+# 변경 로그
+
+이 프로젝트의 주요 변경사항을 기록합니다.
+
+형식은 [Keep a Changelog](https://keepachangelog.com/ko/1.0.0/)를 따르며,
+버저닝은 [Semantic Versioning](https://semver.org/lang/ko/)을 준수합니다.
+
+## [미배포]
+
+## [0.2.0] - 2025-01-26
+
+### 추가
+- **API 라이브러리 통합**
+  - HTTP 클라이언트 옵션: Axios, Fetch API, None
+  - 데이터 페칭 라이브러리: TanStack Query (React Query), SWR, None
+  - 아키텍처별 API 파일 자동 생성 (DDD, Clean, Atomic, Default)
+  - React 및 Next.js용 QueryClient/SWR Provider 자동 설정
+  - 환경변수 파일 자동 생성 (.env.local, .env.example)
+  - TypeScript 타입이 포함된 예제 API 엔드포인트 및 query hooks
+  
+- **CI/CD 자동화**
+  - 자동 테스트 및 배포를 위한 GitHub Actions 워크플로우
+  - main 브랜치 병합 시 자동 npm 배포 (버전 기반)
+  - Node.js 18.x, 20.x, 22.x에서 PR 자동 테스트
+  - TypeScript 검증을 포함한 자동 린트 체크
+  - 배포 시 GitHub Release 자동 생성
+  - 백업용 태그 기반 배포 방식
+
+- **문서**
+  - 버전 추적을 위한 CHANGELOG.md
+  - 개발 가이드라인이 포함된 CONTRIBUTING.md
+  - 상세한 CI/CD 가이드 .github/WORKFLOWS.md
+  - CI 배지 및 배포 정보로 README 업데이트
+
+### 변경
+- **Next.js 프로젝트 구조**
+  - 모든 코드를 `src/` 디렉토리로 정리
+  - tsconfig.json에 절대 경로 alias (`@/*`) 자동 설정
+  - 모든 import를 `@/` 절대 경로로 변환
+  - 모든 `src/**/*` 파일을 스캔하도록 Tailwind 설정 간소화
+  - 깔끔한 루트 디렉토리로 더 나은 프로젝트 구성
+
+### 수정
+- GitHub Actions에서 대화형 프롬프트 문제를 피하기 위해 CI 테스트 워크플로우 간소화
+
+## [0.1.0] - 2024-01-XX
+
+### 추가
+- 초기 MVP 릴리즈
+- 4가지 아키텍처 패턴 지원 (DDD, Clean Architecture, Atomic Design, Default)
+- React (with Vite) 및 Next.js 프레임워크 옵션
+- Next.js 버전 선택 (Latest, 15.x, 14.x, 13.x)
+- Next.js 라우터 선택 (App Router, Pages Router)
+- TypeScript 기본 포함
+- 스타일링 옵션: Tailwind CSS, CSS Modules
+- 상태관리 옵션: Zustand, Context API, None
+- 폼 라이브러리: React Hook Form
+- 테스팅: Vitest + Testing Library
+- 현재 디렉토리 생성 지원 (`.` 옵션)
+- inquirer.js를 사용한 대화형 CLI
+- 자동 폴더 구조 생성
+- 프로젝트 세부정보가 포함된 README.md 생성
+- 환경별 설정 파일
+
+### 문서
+- 사용 예제가 포함된 종합 README
+- 배포 가이드 (PUBLISHING.md)
+- 테스트 가이드 (TESTING.md)
+
+[미배포]: https://github.com/hec8897/create-arch-app/compare/v0.2.0...HEAD
+[0.2.0]: https://github.com/hec8897/create-arch-app/releases/tag/v0.2.0
+[0.1.0]: https://github.com/hec8897/create-arch-app/releases/tag/v0.1.0

package/CHANGELOG.md

@@ -7,6 +7,42 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.2.0] - 2025-01-26
+
+### Added
+- **API Libraries Integration**
+  - HTTP Client options: Axios, Fetch API, None
+  - Data Fetching libraries: TanStack Query (React Query), SWR, None
+  - Architecture-specific API file generation (DDD, Clean, Atomic, Default)
+  - Automatic QueryClient/SWR Provider setup for React and Next.js
+  - Environment variable files (.env.local, .env.example)
+  - Example API endpoints and query hooks with TypeScript
+  
+- **CI/CD Automation**
+  - GitHub Actions workflows for automated testing and deployment
+  - Automatic npm deployment on main branch merge (version-based)
+  - PR testing on Node.js 18.x, 20.x, 22.x
+  - Automated lint checks with TypeScript validation
+  - Automatic GitHub Release creation on deployment
+  - Tag-based deployment as backup method
+
+- **Documentation**
+  - CHANGELOG.md for version tracking
+  - CONTRIBUTING.md with development guidelines
+  - .github/WORKFLOWS.md with detailed CI/CD guide
+  - README updates with CI badges and deployment information
+
+### Changed
+- **Next.js Project Structure**
+  - All code now organized in `src/` directory
+  - Automatic absolute path alias (`@/*`) configuration in tsconfig.json
+  - All imports converted to use `@/` absolute paths
+  - Simplified Tailwind config to scan all `src/**/*` files
+  - Better project organization with cleaner root directory
+
+### Fixed
+- CI test workflow simplified to avoid interactive prompt issues in GitHub Actions
+
 ## [0.1.0] - 2024-01-XX
 
 ### Added

package/README.ko.md

@@ -0,0 +1,302 @@
+# create-arch-app
+
+[![npm version](https://img.shields.io/npm/v/@daawoonkim/create-arch-app.svg)](https://www.npmjs.com/package/@daawoonkim/create-arch-app)
+[![npm downloads](https://img.shields.io/npm/dm/@daawoonkim/create-arch-app.svg)](https://www.npmjs.com/package/@daawoonkim/create-arch-app)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+![Status](https://img.shields.io/badge/status-MVP-orange.svg)
+[![CI Tests](https://github.com/hec8897/create-arch-app/actions/workflows/test.yml/badge.svg)](https://github.com/hec8897/create-arch-app/actions/workflows/test.yml)
+[![Lint](https://github.com/hec8897/create-arch-app/actions/workflows/lint.yml/badge.svg)](https://github.com/hec8897/create-arch-app/actions/workflows/lint.yml)
+
+**🌐 언어**: [English](./README.md) | **한국어**
+
+DDD, Clean Architecture, Atomic Design을 지원하는 대화형 React/Next.js 프로젝트 생성 CLI 도구
+
+**📦 npm**: https://www.npmjs.com/package/@daawoonkim/create-arch-app
+
+**📝 CHANGELOG**: [English](./CHANGELOG.md) | [한국어](./CHANGELOG.ko.md)
+
+> ⚠️ **현재 MVP(Minimum Viable Product) 버전입니다.** 핵심 기능은 모두 작동하지만, 활발히 개발 중이며 피드백을 받고 있습니다. 이슈나 제안 사항이 있으시면 [GitHub Issues](https://github.com/hec8897/create-arch-app/issues)에 남겨주세요!
+
+## 특징
+
+✨ **4가지 아키텍처 패턴 지원**
+- DDD (Domain-Driven Design)
+- Clean Architecture  
+- Atomic Design
+- Default (기본 구조)
+
+🚀 **프레임워크 선택**
+- React (with Vite)
+- Next.js (App Router / Pages Router)
+
+💎 **TypeScript 기본 포함**
+
+🎨 **스타일링 옵션**
+- Tailwind CSS
+- CSS Modules
+
+🌐 **API 통합**
+- HTTP 클라이언트: Axios, Fetch API
+- 데이터 페칭: TanStack Query (React Query), SWR
+
+📦 **선택 가능한 라이브러리**
+- 상태관리: 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. **HTTP 클라이언트**: Axios, Fetch API, None
+9. **데이터 페칭**: TanStack Query (React Query), SWR, None
+10. **테스팅 도구**: 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
+? HTTP 클라이언트를 선택하세요: Axios (권장)
+? 데이터 페칭 라이브러리를 선택하세요: TanStack Query (React Query) - 권장
+? 테스팅 도구를 포함하시겠습니까? 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/
+├── src/
+│   ├── app/
+│   │   ├── layout.tsx
+│   │   ├── page.tsx
+│   │   └── globals.css
+│   └── [architecture folders]
+├── next.config.js
+├── tsconfig.json
+├── package.json
+└── README.md
+```
+
+### Next.js 프로젝트 (Pages Router)
+
+```
+my-app/
+├── src/
+│   ├── 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 이상
+
+## 버전 정보
+
+### v0.2.0 - 최신 (2025-01-26)
+
+**주요 업데이트:**
+- ✅ API 라이브러리 통합 (Axios, Fetch API, TanStack Query, SWR)
+- ✅ 아키텍처별 API 파일 자동 생성
+- ✅ Next.js 프로젝트 구조 개선 (`src/` 디렉토리 + 절대 경로)
+- ✅ CI/CD 자동화 (GitHub Actions)
+- ✅ 자동 npm 배포 (main 브랜치 merge 시)
+- ✅ 문서 개선 (CHANGELOG, CONTRIBUTING, WORKFLOWS)
+
+자세한 내용은 [CHANGELOG.ko.md](./CHANGELOG.ko.md)를 참조하세요.
+
+### v0.1.0 - MVP 릴리즈
+
+**포함된 기능:**
+- ✅ 4가지 아키텍처 패턴 (DDD, Clean Architecture, Atomic Design, Default)
+- ✅ React (Vite) & Next.js (App Router / Pages Router) 지원
+- ✅ Next.js 버전 선택 (Latest, 15.x, 14.x, 13.x)
+- ✅ TypeScript 기본 포함
+- ✅ 스타일링: Tailwind CSS, CSS Modules
+- ✅ 상태관리: Zustand, Context API
+- ✅ 폼: React Hook Form
+- ✅ 테스팅: Vitest + Testing Library
+- ✅ 현재 디렉토리 생성 지원 (`.` 옵션)
+- ✅ 기본 폴더 구조와 README 자동 생성
+
+## 로드맵
+
+### v0.3.0 (계획 중)
+- [ ] 추가 UI 라이브러리 통합 (shadcn/ui, MUI)
+- [ ] 더 많은 테스트 및 안정성 개선
+- [ ] 컴포넌트 생성기 추가
+
+### 향후 계획
+- [ ] 추가 아키텍처 패턴 (Feature-Sliced Design, Hexagonal Architecture)
+- [ ] 추가 상태관리 옵션 (Redux Toolkit, Jotai, Recoil)
+- [ ] 인증 통합 (NextAuth, Supabase)
+- [ ] ORM 통합 (Prisma, Drizzle)
+- [ ] Docker 설정 포함
+- [ ] Monorepo 지원 (Turborepo)
+
+## 기여하기
+
+버그 리포트, 기능 제안, PR 모두 환영합니다!
+
+자세한 내용은 [CONTRIBUTING.md](./CONTRIBUTING.md)를 참조하세요.
+
+## 라이선스
+
+MIT
+
+## 작성자
+
+daawoonkim
+
+## 참고
+
+이 프로젝트는 현대적인 프론트엔드 개발 모범 사례와 다양한 아키텍처 패턴을 기반으로 합니다.

package/README.md

@@ -7,174 +7,186 @@
 [![CI Tests](https://github.com/hec8897/create-arch-app/actions/workflows/test.yml/badge.svg)](https://github.com/hec8897/create-arch-app/actions/workflows/test.yml)
 [![Lint](https://github.com/hec8897/create-arch-app/actions/workflows/lint.yml/badge.svg)](https://github.com/hec8897/create-arch-app/actions/workflows/lint.yml)
 
-DDD, Clean Architecture, Atomic Design을 지원하는 대화형 React/Next.js 프로젝트 생성 CLI 도구
+**🌐 Language**: **English** | [한국어](./README.ko.md)
+
+An interactive CLI tool to create React/Next.js projects with DDD, Clean Architecture, and Atomic Design patterns.
 
 **📦 npm**: https://www.npmjs.com/package/@daawoonkim/create-arch-app
 
-> ⚠️ **현재 MVP(Minimum Viable Product) 버전입니다.** 핵심 기능은 모두 작동하지만, 활발히 개발 중이며 피드백을 받고 있습니다. 이슈나 제안 사항이 있으시면 [GitHub Issues](https://github.com/hec8897/create-arch-app/issues)에 남겨주세요!
+**📝 CHANGELOG**: [English](./CHANGELOG.md) | [한국어](./CHANGELOG.ko.md)
+
+> ⚠️ **Currently in MVP (Minimum Viable Product) stage.** Core features are working, but actively developing and accepting feedback. Please report issues or suggestions on [GitHub Issues](https://github.com/hec8897/create-arch-app/issues)!
 
-## 특징
+## Features
 
-✨ **4가지 아키텍처 패턴 지원**
+✨ **4 Architecture Patterns**
 - DDD (Domain-Driven Design)
 - Clean Architecture  
 - Atomic Design
-- Default (기본 구조)
+- Default (simple structure)
 
-🚀 **프레임워크 선택**
+🚀 **Framework Options**
 - React (with Vite)
 - Next.js (App Router / Pages Router)
 
-💎 **TypeScript 기본 포함**
+💎 **TypeScript by Default**
 
-🎨 **스타일링 옵션**
+🎨 **Styling Options**
 - Tailwind CSS
 - CSS Modules
 
-📦 **선택 가능한 라이브러리**
-- 상태관리: Zustand, Context API
-- 폼: React Hook Form
-- 테스팅: Vitest + Testing Library
+🌐 **API Integration**
+- HTTP Clients: Axios, Fetch API
+- Data Fetching: TanStack Query (React Query), SWR
 
-## 설치 및 사용법
+📦 **Optional Libraries**
+- State Management: Zustand, Context API
+- Forms: React Hook Form
+- Testing: Vitest + Testing Library
 
-### npx로 즉시 사용 (권장)
+## Installation & Usage
+
+### Quick Start with npx (Recommended)
 
 ```bash
-# 새 디렉토리에 프로젝트 생성
+# Create project in a new directory
 npx @daawoonkim/create-arch-app my-app
 
-# 또는 현재 디렉토리에 직접 생성
+# Or create in the current directory
 npx @daawoonkim/create-arch-app .
 ```
 
-### 전역 설치
+### Global Installation
 
 ```bash
 npm install -g @daawoonkim/create-arch-app
 
-# 새 디렉토리에 프로젝트 생성
+# Create project in a new directory
 create-arch-app my-app
 
-# 현재 디렉토리에 직접 생성
+# Create in current directory
 create-arch-app .
 ```
 
-> **참고**: 현재 디렉토리(`.`)를 사용하려면 디렉토리가 비어있어야 합니다.
+> **Note**: When using current directory (`.`), the directory must be empty.
 
-### 대화형 프롬프트
+### Interactive Prompts
 
-CLI를 실행하면 다음 질문들에 답하게 됩니다:
+When you run the CLI, you'll answer these questions:
 
-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 포함 여부
+1. **Framework**: React or Next.js
+2. **Next.js Version** (Next.js only): Latest (recommended), 15.x, 14.x, 13.x
+3. **Router** (Next.js only): App Router (recommended) or Pages Router
+4. **Architecture Pattern**: DDD, Clean, Atomic, Default
+5. **Styling**: Tailwind CSS or CSS Modules
+6. **State Management**: Zustand, Context API, None
+7. **Form Library**: React Hook Form or None
+8. **HTTP Client**: Axios, Fetch API, None
+9. **Data Fetching**: TanStack Query (React Query), SWR, None
+10. **Testing**: Include Vitest + Testing Library
 
-## 사용 예시
+## Example Usage
 
 ```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 사용
-✅ 프로젝트 생성 완료!
-
-🎉 프로젝트가 성공적으로 생성되었습니다!
-
-다음 명령어로 시작하세요:
+# Interactive prompts
+? Select framework: Next.js
+? Select Next.js version: Latest (Recommended)
+? Select Next.js router: App Router (Recommended)
+? Select architecture pattern: DDD (Domain-Driven Design)
+? Select styling tool: Tailwind CSS
+? Select state management: Zustand
+? Select form library: React Hook Form
+? Select HTTP client: Axios (Recommended)
+? Select data fetching library: TanStack Query (React Query) - Recommended
+? Include testing tools? Yes
+
+✨ Creating project...
+📦 Setting up TypeScript project (default)
+🚀 Using Next.js App Router
+✅ Project created!
+
+🎉 Project successfully created!
+
+Get started with:
   cd my-enterprise-app
   npm install
   npm run dev
 ```
 
-## 아키텍처 패턴 설명
+## Architecture Patterns
 
 ### DDD (Domain-Driven Design)
 
-엔터프라이즈급 애플리케이션에 적합한 패턴입니다.
+Perfect for enterprise-grade applications.
 
 ```
-domain/          # 비즈니스 엔티티와 로직
+domain/          # Business entities and logic
   ├── entities/
   ├── repositories/
   └── services/
-application/     # 유스케이스
+application/     # Use cases
   ├── usecases/
   └── ports/
-infrastructure/  # 외부 서비스 통합
+infrastructure/  # External service integration
   ├── api/
   └── persistence/
-presentation/    # UI 컴포넌트
+presentation/    # UI components
   ├── components/
   └── pages/
 ```
 
 ### Clean Architecture
 
-의존성 규칙과 레이어 분리에 중점을 둔 패턴입니다.
+Focuses on dependency rules and layer separation.
 
 ```
-core/           # 비즈니스 로직
+core/           # Business logic
   ├── entities/
   ├── usecases/
   └── interfaces/
-features/       # 기능별 모듈
+features/       # Feature modules
   └── [feature]/
       ├── domain/
       ├── data/
       └── presentation/
-shared/         # 공통 컴포넌트
+shared/         # Shared components
   ├── components/
   └── utils/
 ```
 
 ### Atomic Design
 
-UI 컴포넌트 중심 개발에 최적화된 패턴입니다.
+Optimized for UI component-driven development.
 
 ```
 components/
-  ├── atoms/      # 가장 작은 UI 단위
-  ├── molecules/  # atoms 조합
-  ├── organisms/  # molecules 조합
-  ├── templates/  # 페이지 레이아웃
-  └── pages/      # 실제 페이지
+  ├── atoms/      # Smallest UI units
+  ├── molecules/  # Combinations of atoms
+  ├── organisms/  # Combinations of molecules
+  ├── templates/  # Page layouts
+  └── pages/      # Actual pages
 hooks/
 utils/
 ```
 
 ### Default
 
-빠른 시작을 원하는 개발자를 위한 기본 구조입니다.
+Simple structure for quick start.
 
 ```
 components/
 hooks/
-pages/ (또는 app/)
+pages/ (or app/)
 utils/
 styles/
 types/
 ```
 
-## 생성되는 파일 구조
+## Generated File Structure
 
-### React 프로젝트
+### React Project
 
 ```
 my-app/
@@ -190,152 +202,101 @@ my-app/
 └── README.md
 ```
 
-### Next.js 프로젝트 (App Router)
+### Next.js Project (App Router)
 
 ```
 my-app/
-├── app/
-│   ├── layout.tsx
-│   ├── page.tsx
-│   └── globals.css
-├── [architecture folders]
+├── src/
+│   ├── app/
+│   │   ├── layout.tsx
+│   │   ├── page.tsx
+│   │   └── globals.css
+│   └── [architecture folders]
 ├── next.config.js
 ├── tsconfig.json
 ├── package.json
 └── README.md
 ```
 
-### Next.js 프로젝트 (Pages Router)
+### Next.js Project (Pages Router)
 
 ```
 my-app/
-├── pages/
-│   ├── _app.tsx
-│   ├── _document.tsx
-│   └── index.tsx
-├── styles/
-│   └── globals.css
-├── [architecture folders]
+├── src/
+│   ├── pages/
+│   │   ├── _app.tsx
+│   │   ├── _document.tsx
+│   │   └── index.tsx
+│   ├── styles/
+│   │   └── globals.css
+│   └── [architecture folders]
 ├── next.config.js
 ├── tsconfig.json
 ├── package.json
 └── README.md
 ```
 
-## 요구 사항
+## Requirements
 
-- Node.js 18.0.0 이상
+- Node.js 18.0.0 or higher
 
-## 개발
+## Version History
 
-이 프로젝트를 로컬에서 개발하려면:
+### v0.2.0 - Latest (2025-01-26)
 
-```bash
-# 저장소 클론
-git clone git@github.com:hec8897/create-arch-app.git
-cd create-arch-app
-
-# 의존성 설치
-npm install
-
-# TypeScript 컴파일
-npm run build
-
-# 로컬 링크 생성
-npm link
+**Major Updates:**
+- ✅ API library integration (Axios, Fetch API, TanStack Query, SWR)
+- ✅ Architecture-specific API file generation
+- ✅ Improved Next.js project structure (`src/` directory + absolute paths)
+- ✅ CI/CD automation (GitHub Actions)
+- ✅ Automatic npm deployment on main branch merge
+- ✅ Enhanced documentation (CHANGELOG, CONTRIBUTING, WORKFLOWS)
 
-# 테스트
-cd ~/test-project
-create-arch-app my-test-app
-```
-
-### npm 배포
+See [CHANGELOG.md](./CHANGELOG.md) for details.
 
-npm 배포 방법은 [PUBLISHING.md](./PUBLISHING.md)를 참조하세요.
+### v0.1.0 - MVP Release
 
-**자동 배포:** main 브랜치에 merge되면 자동으로 npm 배포가 실행됩니다!
+**Features:**
+- ✅ 4 architecture patterns (DDD, Clean Architecture, Atomic Design, Default)
+- ✅ React (Vite) & Next.js (App Router / Pages Router) support
+- ✅ Next.js version selection (Latest, 15.x, 14.x, 13.x)
+- ✅ TypeScript by default
+- ✅ Styling: Tailwind CSS, CSS Modules
+- ✅ State Management: Zustand, Context API
+- ✅ Forms: React Hook Form
+- ✅ Testing: Vitest + Testing Library
+- ✅ Current directory creation support (`.` option)
+- ✅ Automatic folder structure and README generation
 
-```bash
-# 1. 버전 업데이트
-npm version patch  # 0.1.0 → 0.1.1
+## Roadmap
 
-# 2. PR 생성 및 merge
-# main에 merge → 자동 배포!
+### v0.3.0 (Planned)
+- [ ] Additional UI library integration (shadcn/ui, MUI)
+- [ ] More testing and stability improvements
+- [ ] Component generator
 
-# 자세한 내용: .github/WORKFLOWS.md
-```
+### Future Plans
+- [ ] Additional architecture patterns (Feature-Sliced Design, Hexagonal Architecture)
+- [ ] More state management options (Redux Toolkit, Jotai, Recoil)
+- [ ] Authentication integration (NextAuth, Supabase)
+- [ ] ORM integration (Prisma, Drizzle)
+- [ ] Docker setup
+- [ ] Monorepo support (Turborepo)
 
-## 버전 정보
+## Contributing
 
-### v0.1.0 - MVP 릴리즈 (현재)
+Bug reports, feature suggestions, and PRs are welcome!
 
-**포함된 기능:**
-- ✅ 4가지 아키텍처 패턴 (DDD, Clean Architecture, Atomic Design, Default)
-- ✅ React (Vite) & Next.js (App Router / Pages Router) 지원
-- ✅ Next.js 버전 선택 (Latest, 15.x, 14.x, 13.x)
-- ✅ TypeScript 기본 포함
-- ✅ 스타일링: Tailwind CSS, CSS Modules
-- ✅ 상태관리: Zustand, Context API
-- ✅ 폼: React Hook Form
-- ✅ 테스팅: Vitest + Testing Library
-- ✅ 현재 디렉토리 생성 지원 (`.` 옵션)
-
-**알려진 제한사항:**
-- 일부 조합에서 테스트가 완료되지 않았을 수 있습니다
-- 에러 처리 개선 필요
-- 더 많은 커스터마이징 옵션 추가 예정
-
-## 로드맵
-
-### v0.2.0 (계획 중)
-- [ ] 추가 UI 라이브러리 통합 (shadcn/ui, MUI)
-- [ ] 더 많은 테스트 및 안정성 개선
-- [ ] 컴포넌트 생성기 추가
-
-### v0.3.0 이후
-- [ ] 추가 아키텍처 패턴 (Feature-Sliced Design, Hexagonal Architecture)
-- [ ] 추가 상태관리 옵션 (Redux Toolkit, Jotai, Recoil)
-- [ ] 인증 통합 (NextAuth, Supabase)
-- [ ] ORM 통합 (Prisma, Drizzle)
-- [ ] CI/CD 설정 자동화
-- [ ] Docker 설정 포함
-- [ ] Monorepo 지원 (Turborepo)
-
-## 기여하기
-
-버그 리포트, 기능 제안, PR 모두 환영합니다!
-
-자세한 내용은 [CONTRIBUTING.md](./CONTRIBUTING.md)를 참조하세요.
-
-### 개발 환경 설정
-
-```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
-```
+See [CONTRIBUTING.md](./CONTRIBUTING.md) for details.
 
-## 라이선스
+## License
 
 MIT
 
-## 작성자
+## Author
 
 daawoonkim
 
-## 참고
+## Credits
 
-이 프로젝트는 현대적인 프론트엔드 개발 모범 사례와 다양한 아키텍처 패턴을 기반으로 합니다.
+This project is based on modern frontend development best practices and various architectural patterns.

package/create-arch-app_mvp_faa8b53b.plan.md

@@ -0,0 +1,454 @@
+---
+name: create-arch-app MVP
+overview: DDD, Clean Architecture, Atomic Design을 지원하는 React/Next.js 보일러플레이트 CLI 도구를 개발하고 npm에 배포합니다. MVP는 4개 아키텍처 패턴과 핵심 라이브러리 선택 기능을 포함합니다.
+todos:
+  - id: setup-project
+    content: 프로젝트 초기화 및 TypeScript 설정, 필수 의존성 설치
+    status: completed
+  - id: cli-structure
+    content: CLI 진입점 및 Commander.js 명령어 구조 구현
+    status: completed
+  - id: prompts
+    content: inquirer.js 대화형 프롬프트 구현 (프레임워크, 아키텍처, 라이브러리 선택)
+    status: completed
+  - id: templates-ddd
+    content: DDD 아키텍처 템플릿 작성 (React, Next.js)
+    status: completed
+  - id: templates-clean
+    content: Clean Architecture 템플릿 작성 (React, Next.js)
+    status: completed
+  - id: templates-default
+    content: Default 기본 구조 템플릿 작성 (React, Next.js)
+    status: completed
+  - id: templates-atomic
+    content: Atomic Design 템플릿 작성 (React, Next.js)
+    status: completed
+  - id: file-generator
+    content: 파일 시스템 로직 구현 (템플릿 복사, 동적 파일 생성)
+    status: completed
+  - id: package-json-gen
+    content: 선택한 라이브러리에 따른 package.json 동적 생성
+    status: completed
+  - id: config-files
+    content: 설정 파일 생성 로직 (tsconfig, tailwind.config 등)
+    status: completed
+  - id: testing
+    content: 32가지 주요 조합 테스트 및 검증
+    status: pending
+  - id: documentation
+    content: README.md, LICENSE 작성 및 npm 메타데이터 설정
+    status: completed
+  - id: git-setup
+    content: GitHub 저장소 설정 및 첫 커밋 푸시
+    status: completed
+  - id: npm-publish
+    content: npm 배포 및 v0.1.0 릴리즈
+    status: completed
+isProject: false
+---
+
+# create-arch-app CLI 도구 개발 및 배포 계획
+
+## 프로젝트 개요
+
+**패키지명**: `create-arch-app`
+
+**목표**: DDD, Clean Architecture, Atomic Design을 지원하는 대화형 React/Next.js 프로젝트 생성 CLI
+
+**MVP 범위**: 4개 아키텍처 패턴 + React/Next.js + 핵심 라이브러리 5가지
+
+## 아키텍처 결정
+
+### 지원할 아키텍처 패턴 (MVP)
+
+1. **DDD (Domain-Driven Design)**
+   - 폴더 구조: `domain/`, `application/`, `infrastructure/`, `presentation/`
+   - 엔터프라이즈급 애플리케이션에 적합
+
+2. **Clean Architecture**
+   - 폴더 구조: `core/`, `features/`, `shared/`, `app/`
+   - 의존성 규칙과 레이어 분리 중심
+
+3. **Atomic Design**
+   - 폴더 구조: `atoms/`, `molecules/`, `organisms/`, `templates/`, `pages/`
+   - UI 컴포넌트 중심 개발에 최적화
+
+4. **Default (기본 구조)**
+   - 폴더 구조: `components/`, `pages/`, `hooks/`, `utils/`, `styles/`
+   - 빠른 시작을 원하는 개발자용
+
+### 지원할 라이브러리 (MVP)
+
+- **TypeScript**: 기본 활성화 (모든 프로젝트에 기본 포함)
+- **번들러**: Vite (React 프로젝트용, Next.js는 자체 번들러 사용)
+- **스타일링**: Tailwind CSS / CSS Modules
+- **상태관리**: Zustand / Context API / None
+- **폼 관리**: React Hook Form / None
+- **테스팅**: Vitest + Testing Library / None
+
+## 기술 스택
+
+### CLI 도구 개발
+
+- **언어**: TypeScript
+- **CLI 프레임워크**: Commander.js (명령어 파싱)
+- **대화형 프롬프트**: inquirer.js
+- **파일 시스템**: fs-extra
+- **템플릿 엔진**: Handlebars (동적 파일 생성)
+- **패키지 관리자 감지**: which-pm-runs, which-pm
+
+### 생성되는 프로젝트 기술 스택
+
+- **TypeScript**: 모든 프로젝트에 기본 포함
+- **React 번들러**: Vite (빠른 개발 서버 및 빌드)
+- **Next.js 번들러**: 내장 번들러 (Turbopack/Webpack)
+
+### 프로젝트 구조
+
+```
+create-arch-app/
+├── bin/
+│   └── cli.js                 # CLI 진입점
+├── src/
+│   ├── commands/
+│   │   └── create.ts          # 프로젝트 생성 명령
+│   ├── prompts/
+│   │   └── projectSetup.ts    # 대화형 질문
+│   ├── generators/
+│   │   ├── react.ts           # React 프로젝트 생성
+│   │   └── nextjs.ts          # Next.js 프로젝트 생성
+│   ├── templates/
+│   │   ├── react/
+│   │   │   ├── ddd/           # DDD 구조 템플릿
+│   │   │   ├── clean/         # Clean Architecture 템플릿
+│   │   │   ├── atomic/        # Atomic Design 템플릿
+│   │   │   └── default/       # 기본 구조 템플릿
+│   │   └── nextjs/
+│   │       ├── app-router/    # App Router 기반
+│   │       │   ├── ddd/
+│   │       │   ├── clean/
+│   │       │   ├── atomic/
+│   │       │   └── default/
+│   │       └── pages-router/  # Pages Router 기반
+│   │           ├── ddd/
+│   │           ├── clean/
+│   │           ├── atomic/
+│   │           └── default/
+│   ├── utils/
+│   │   ├── fileSystem.ts      # 파일 복사/생성
+│   │   ├── packageManager.ts  # npm/yarn/pnpm 감지
+│   │   └── dependencies.ts    # package.json 생성
+│   └── index.ts
+├── package.json
+├── tsconfig.json
+└── README.md
+```
+
+## 구현 단계
+
+### Phase 1: CLI 기본 구조 (1-2일)
+
+**핵심 파일 구성**:
+
+- `package.json`: bin 필드에 CLI 진입점 설정
+- `bin/cli.js`: Shebang(#!/usr/bin/env node) 추가
+- `src/index.ts`: Commander.js로 명령어 정의
+- `src/prompts/projectSetup.ts`: inquirer.js로 대화형 질문 구현
+
+**주요 프롬프트 항목**:
+
+```typescript
+// 예시 코드
+{
+  projectName: string,
+  framework: 'react' | 'nextjs',
+  router?: 'app' | 'pages',  // Next.js만 해당
+  architecture: 'ddd' | 'clean' | 'atomic' | 'default',
+  // typescript: true (기본값, 프롬프트에서 제외)
+  styling: 'tailwind' | 'css-modules',
+  stateManagement: 'zustand' | 'context' | 'none',
+  formLibrary: 'react-hook-form' | 'none',
+  testing: boolean
+}
+```
+
+### Phase 2: 템플릿 작성 (3-4일)
+
+각 아키텍처별로 템플릿 폴더 구조 생성:
+
+**템플릿 구분**:
+
+- React (Vite): 단일 템플릿
+- Next.js: App Router / Pages Router 각각 별도 템플릿
+
+**Next.js 라우터별 차이점**:
+
+- App Router: `app/` 디렉토리, Server Components 기본, `layout.tsx`, `page.tsx`
+- Pages Router: `pages/` 디렉토리, `_app.tsx`, `_document.tsx`, `index.tsx`
+
+**DDD 템플릿 구조**:
+
+```
+domain/
+  ├── entities/          # 비즈니스 엔티티
+  ├── repositories/      # 리포지토리 인터페이스
+  └── services/          # 도메인 서비스
+application/
+  ├── usecases/         # 유스케이스
+  └── ports/            # 포트 인터페이스
+infrastructure/
+  ├── api/              # API 클라이언트
+  └── persistence/      # 데이터 영속성
+presentation/
+  ├── components/       # UI 컴포넌트
+  └── pages/            # 페이지
+```
+
+**Clean Architecture 템플릿**:
+
+```
+core/
+  ├── entities/
+  ├── usecases/
+  └── interfaces/
+features/
+  └── [feature-name]/
+      ├── domain/
+      ├── data/
+      └── presentation/
+shared/
+  ├── components/
+  └── utils/
+```
+
+**Atomic Design 템플릿**:
+
+```
+components/
+  ├── atoms/           # 가장 작은 UI 단위 (Button, Input, Label)
+  ├── molecules/       # atoms 조합 (SearchBar, FormField)
+  ├── organisms/       # molecules 조합 (Header, Footer, Form)
+  ├── templates/       # 페이지 레이아웃
+  └── pages/           # 실제 페이지 구현
+hooks/
+utils/
+styles/
+types/
+```
+
+**Default 템플릿**:
+
+```
+components/
+hooks/
+pages/ (또는 app/)
+utils/
+styles/
+types/
+```
+
+**React 프로젝트 추가 설정 파일**:
+
+- `vite.config.ts`: Vite 설정
+- `index.html`: Vite 진입점
+- `src/main.tsx`: 애플리케이션 진입점
+
+**Next.js 프로젝트 설정 파일**:
+
+- `next.config.js`: Next.js 설정
+
+**App Router (Next.js 13+)** 사용 시:
+
+- `app/layout.tsx`: 루트 레이아웃
+- `app/page.tsx`: 홈 페이지
+- `app/globals.css`: 전역 스타일
+
+**Pages Router (Next.js 12 이하)** 사용 시:
+
+- `pages/_app.tsx`: 앱 래퍼
+- `pages/_document.tsx`: 문서 구조
+- `pages/index.tsx`: 홈 페이지
+- `styles/globals.css`: 전역 스타일
+
+**공통 TypeScript 설정**:
+
+- `tsconfig.json`: 모든 프로젝트에 포함
+- `tsconfig.node.json`: Vite 프로젝트용 (Node 환경)
+
+Handlebars 템플릿 예시 (모든 파일이 TypeScript):
+
+```handlebars
+export interface Props { title: string; } export const Component = ({ title }:
+Props) => { return
+<div>{title}</div>; };
+```
+
+### Phase 3: 파일 생성 로직 (2-3일)
+
+**핵심 기능**:
+
+1. 선택한 아키텍처에 맞는 폴더 구조 생성
+2. 선택한 라이브러리에 따라 `package.json` 동적 생성
+3. 설정 파일 생성 (tsconfig.json, tailwind.config.js 등)
+4. README.md 자동 생성 (선택한 옵션 기반)
+
+**의존성 매핑**:
+
+```typescript
+const dependencies = {
+  react: {
+    react: "^18.2.0",
+    "react-dom": "^18.2.0",
+  },
+  reactDev: {
+    vite: "^5.0.0",
+    "@vitejs/plugin-react": "^4.2.0",
+    typescript: "^5.3.0",
+    "@types/react": "^18.2.0",
+    "@types/react-dom": "^18.2.0",
+  },
+  nextjs: {
+    next: "^14.0.0",
+    react: "^18.2.0",
+    typescript: "^5.3.0",
+    "@types/react": "^18.2.0",
+    "@types/node": "^20.0.0",
+  },
+  tailwind: {
+    tailwindcss: "^3.4.0",
+    autoprefixer: "^10.4.0",
+    postcss: "^8.4.0",
+  },
+  zustand: { zustand: "^4.4.0" },
+  // ...
+};
+```
+
+### Phase 4: 테스트 및 검증 (1-2일)
+
+1. 각 조합별 프로젝트 생성 테스트 (모두 TypeScript 기본)
+   - React + Vite + DDD + Tailwind
+   - Next.js + App Router + Clean + Zustand
+   - Next.js + Pages Router + DDD + CSS Modules
+   - React + Vite + Atomic + CSS Modules
+   - 총 32가지 주요 조합 검증 (Next.js 라우터 2가지 × 4 아키텍처 = 8가지 추가)
+
+2. 생성된 프로젝트가 정상 실행되는지 확인
+   - `npm install` 성공
+   - `npm run dev` 실행 (React: Vite 개발 서버, Next.js: Next.js 개발 서버)
+   - TypeScript 컴파일 오류 없음
+   - 빌드 오류 없음 (`npm run build`)
+
+### Phase 5: npm 배포 (1일)
+
+**배포 전 체크리스트**:
+
+- [ ] package.json 메타데이터 작성
+  - name, version, description
+  - keywords, author, license
+  - repository, bugs, homepage
+- [ ] README.md 작성
+  - 설치 방법
+  - 사용 예시
+  - 지원하는 옵션
+  - 예시 스크린샷
+- [ ] LICENSE 파일 (MIT 권장)
+- [ ] .npmignore 설정 (불필요한 파일 제외)
+
+**npm 계정 및 배포**:
+
+```bash
+npm login
+npm publish --access public
+```
+
+**버전 관리**:
+
+- 초기 릴리즈: v0.1.0 (MVP)
+- Semantic Versioning 적용
+
+## 실행 플로우
+
+```mermaid
+flowchart TD
+    Start[npx create-arch-app my-app] --> CheckName{프로젝트명 유효?}
+    CheckName -->|No| AskName[프로젝트명 입력]
+    CheckName -->|Yes| Framework[프레임워크 선택]
+    AskName --> Framework
+
+    Framework --> Router{Next.js?}
+    Router -->|Yes| RouterType[라우터 선택: App/Pages]
+    Router -->|No React| Arch[아키텍처 패턴 선택]
+    RouterType --> Arch
+    Arch --> Style[스타일링 도구 선택]
+    Style --> State[상태관리 선택]
+    State --> Form[폼 라이브러리 선택]
+    Form --> Test[테스팅 도구 선택]
+
+    Test --> Generate[파일 생성]
+    Generate --> Install[의존성 설치]
+    Install --> Success[완료 메시지 출력]
+
+    Success --> End[프로젝트 준비 완료]
+```
+
+## 예상 사용 시나리오
+
+### 사용자 실행 예시
+
+```bash
+npx create-arch-app my-enterprise-app
+
+# 대화형 프롬프트
+? 프레임워크를 선택하세요: Next.js
+? 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 run dev
+```
+
+## MVP 이후 확장 가능성
+
+1. **추가 아키텍처 패턴**
+   - Feature-Sliced Design
+   - Modular Architecture
+   - Hexagonal Architecture
+
+2. **더 많은 라이브러리 옵션**
+   - UI: shadcn/ui, MUI, Ant Design
+   - 상태관리: Redux Toolkit, Jotai, Recoil
+   - 인증: NextAuth, Supabase
+   - ORM: Prisma, Drizzle
+
+3. **고급 기능**
+   - 컴포넌트 생성기 (rorg 처럼)
+   - CI/CD 설정 자동화
+   - Docker 설정 포함
+   - Monorepo 지원 (Turborepo)
+
+## 성공 지표
+
+- npm 다운로드 수
+- GitHub 스타 수
+- 커뮤니티 피드백 및 이슈
+- 실제 프로덕션 사용 사례
+
+## 참고 리소스
+
+- **유사 프로젝트 분석**: rorg, CleanNextBoilerplateCLI
+- **템플릿 참고**: nextjs-clean-architecture-starter
+- **CLI 개발 가이드**: Commander.js, inquirer.js 공식 문서

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@daawoonkim/create-arch-app",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "CLI tool to scaffold React/Next.js projects with DDD, Clean Architecture, and Atomic Design patterns",
   "type": "module",
   "bin": {