{"_id":"@daawoonkim/create-arch-app","_rev":"3-cd82a3a6f70597a70358221521a0e402","name":"@daawoonkim/create-arch-app","dist-tags":{"latest":"0.2.1"},"versions":{"0.1.0":{"name":"@daawoonkim/create-arch-app","version":"0.1.0","keywords":["react","nextjs","ddd","clean-architecture","atomic-design","boilerplate","cli","scaffold","typescript"],"author":{"name":"daawoonkim"},"license":"MIT","_id":"@daawoonkim/create-arch-app@0.1.0","maintainers":[{"name":"daawoonkim","email":"hec8897@gmail.com"}],"homepage":"https://github.com/hec8897/create-arch-app#readme","bugs":{"url":"https://github.com/hec8897/create-arch-app/issues"},"bin":{"create-arch-app":"bin/cli.js"},"dist":{"shasum":"5c75b1f52c3a9cba28936a265854f9f4fb3e2236","tarball":"https://registry.npmjs.org/@daawoonkim/create-arch-app/-/create-arch-app-0.1.0.tgz","fileCount":42,"integrity":"sha512-NDBP0OhpySw24exUyqRnc0Ogyv6SWwLJzF2/zFFMirim07VyC4sLLbI1BfN8Xh8CBl1hBGArqFupJHa5v81JtQ==","signatures":[{"sig":"MEUCIBYA9c81qsa93UTBWy5swlKdEC9bqOG9URsvWwKnYPQ8AiEA1qGIJy5SHIvGk0+6luv/pSWn1fVEhHQf3liMnKJjee4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":93049},"type":"module","engines":{"node":">=18.0.0"},"gitHead":"daa121c5377f88d3650995422ec25eb3b46edca6","scripts":{"dev":"tsc --watch","build":"tsc","prepublishOnly":"npm run build"},"_npmUser":{"name":"daawoonkim","email":"hec8897@gmail.com"},"repository":{"url":"git+ssh://git@github.com/hec8897/create-arch-app.git","type":"git"},"_npmVersion":"10.2.4","description":"CLI tool to scaffold React/Next.js projects with DDD, Clean Architecture, and Atomic Design patterns","directories":{},"_nodeVersion":"21.4.0","dependencies":{"ora":"^8.0.1","chalk":"^5.3.0","fs-extra":"^11.2.0","inquirer":"^9.2.12","commander":"^11.1.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.3","@types/node":"^20.10.6","@types/fs-extra":"^11.0.4","@types/inquirer":"^9.0.7"},"_npmOperationalInternal":{"tmp":"tmp/create-arch-app_0.1.0_1769137681122_0.5334009446311074","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@daawoonkim/create-arch-app","version":"0.2.0","keywords":["react","nextjs","ddd","clean-architecture","atomic-design","boilerplate","cli","scaffold","typescript"],"author":{"name":"daawoonkim"},"license":"MIT","_id":"@daawoonkim/create-arch-app@0.2.0","maintainers":[{"name":"daawoonkim","email":"hec8897@gmail.com"}],"homepage":"https://github.com/hec8897/create-arch-app#readme","bugs":{"url":"https://github.com/hec8897/create-arch-app/issues"},"bin":{"create-arch-app":"bin/cli.js"},"dist":{"shasum":"469114e900d33d59da140189efbf45fe6bdba956","tarball":"https://registry.npmjs.org/@daawoonkim/create-arch-app/-/create-arch-app-0.2.0.tgz","fileCount":53,"integrity":"sha512-W0SAcB1gnPYjgQmLyxOCZXP6iXzmyrsKNRwBi3ZwmM7wL43cH5uvt2Rm///pWY4HhWVb15xWosHZnj6cTz6fFA==","signatures":[{"sig":"MEQCIAZjMhxKom3vWqHqx6FC/uEulD/1HdEGlrewHOJeoVBvAiBnuIS9V8FzrMg+ExlpQaeXPPM3LUHR4RGzUMG5JPN6Dw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":136130},"type":"module","engines":{"node":">=18.0.0"},"gitHead":"006c7a8c7aaf932441de6206e54d91185e015597","scripts":{"dev":"tsc --watch","build":"tsc","prepublishOnly":"npm run build"},"_npmUser":{"name":"daawoonkim","email":"hec8897@gmail.com"},"repository":{"url":"git+ssh://git@github.com/hec8897/create-arch-app.git","type":"git"},"_npmVersion":"10.8.2","description":"CLI tool to scaffold React/Next.js projects with DDD, Clean Architecture, and Atomic Design patterns","directories":{},"_nodeVersion":"20.20.0","dependencies":{"ora":"^8.0.1","chalk":"^5.3.0","fs-extra":"^11.2.0","inquirer":"^9.2.12","commander":"^11.1.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.3","@types/node":"^20.10.6","@types/fs-extra":"^11.0.4","@types/inquirer":"^9.0.7"},"_npmOperationalInternal":{"tmp":"tmp/create-arch-app_0.2.0_1769399653881_0.023000098444671213","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@daawoonkim/create-arch-app","version":"0.2.1","description":"CLI tool to scaffold React/Next.js projects with DDD, Clean Architecture, and Atomic Design patterns","type":"module","bin":{"create-arch-app":"bin/cli.js"},"scripts":{"build":"tsc","dev":"tsc --watch","prepublishOnly":"npm run build"},"keywords":["react","nextjs","ddd","clean-architecture","atomic-design","boilerplate","cli","scaffold","typescript"],"author":{"name":"daawoonkim"},"license":"MIT","repository":{"type":"git","url":"git+ssh://git@github.com/hec8897/create-arch-app.git"},"bugs":{"url":"https://github.com/hec8897/create-arch-app/issues"},"homepage":"https://github.com/hec8897/create-arch-app#readme","dependencies":{"commander":"^11.1.0","inquirer":"^9.2.12","fs-extra":"^11.2.0","chalk":"^5.3.0","ora":"^8.0.1"},"devDependencies":{"@types/node":"^20.10.6","@types/fs-extra":"^11.0.4","@types/inquirer":"^9.0.7","typescript":"^5.3.3"},"engines":{"node":">=18.0.0"},"_id":"@daawoonkim/create-arch-app@0.2.1","gitHead":"71c41a8125ff0798f328b1718e25c763bfbd32ce","_nodeVersion":"21.4.0","_npmVersion":"10.2.4","dist":{"integrity":"sha512-SL4ZLf7cVxvJPOf5fy3ebg9A0ERNwTuoSOHkPqd9/Zdbv/c0HLOwo9Si8SjwyLCfbxoKCsVB/RZcu/Pcm79/HQ==","shasum":"ea64cca637622dbc2aec5705a5aa4faa01a3fe93","tarball":"https://registry.npmjs.org/@daawoonkim/create-arch-app/-/create-arch-app-0.2.1.tgz","fileCount":56,"unpackedSize":161752,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCICTNT6+S39Qg3QaYkDtmFMMcSq8gRMxknHLeofWXtPASAiEAjBd4FS3VUHTWvu1tkHpXCdcUn2R9577xLOSUGje0EhQ="}]},"_npmUser":{"name":"daawoonkim","email":"hec8897@gmail.com"},"directories":{},"maintainers":[{"name":"daawoonkim","email":"hec8897@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/create-arch-app_0.2.1_1769403052807_0.8090126701464504"},"_hasShrinkwrap":false}},"time":{"created":"2026-01-23T03:08:01.015Z","modified":"2026-01-26T04:50:53.066Z","0.1.0":"2026-01-23T03:08:01.276Z","0.2.0":"2026-01-26T03:54:14.028Z","0.2.1":"2026-01-26T04:50:52.958Z"},"bugs":{"url":"https://github.com/hec8897/create-arch-app/issues"},"author":{"name":"daawoonkim"},"license":"MIT","homepage":"https://github.com/hec8897/create-arch-app#readme","keywords":["react","nextjs","ddd","clean-architecture","atomic-design","boilerplate","cli","scaffold","typescript"],"repository":{"type":"git","url":"git+ssh://git@github.com/hec8897/create-arch-app.git"},"description":"CLI tool to scaffold React/Next.js projects with DDD, Clean Architecture, and Atomic Design patterns","maintainers":[{"name":"daawoonkim","email":"hec8897@gmail.com"}],"readme":"# create-arch-app\n\n[![npm version](https://img.shields.io/npm/v/@daawoonkim/create-arch-app.svg)](https://www.npmjs.com/package/@daawoonkim/create-arch-app)\n[![npm downloads](https://img.shields.io/npm/dm/@daawoonkim/create-arch-app.svg)](https://www.npmjs.com/package/@daawoonkim/create-arch-app)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n![Status](https://img.shields.io/badge/status-MVP-orange.svg)\n[![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)\n[![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)\n\n**šŸŒ Language**: **English** | [ķ•œźµ­ģ–“](./README.ko.md)\n\nAn interactive CLI tool to create React/Next.js projects with DDD, Clean Architecture, and Atomic Design patterns.\n\n**šŸ“¦ npm**: https://www.npmjs.com/package/@daawoonkim/create-arch-app\n\n**šŸ“ CHANGELOG**: [English](./CHANGELOG.md) | [ķ•œźµ­ģ–“](./CHANGELOG.ko.md)\n\n> āš ļø **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)!\n\n## Features\n\nāœØ **4 Architecture Patterns**\n- DDD (Domain-Driven Design)\n- Clean Architecture \n- Atomic Design\n- Default (simple structure)\n\nšŸš€ **Framework Options**\n- React (with Vite)\n- Next.js (App Router / Pages Router)\n\nšŸ’Ž **TypeScript by Default**\n\nšŸŽØ **Styling Options**\n- Tailwind CSS\n- CSS Modules\n\nšŸŒ **API Integration**\n- HTTP Clients: Axios, Fetch API\n- Data Fetching: TanStack Query (React Query), SWR\n\nšŸ“¦ **Optional Libraries**\n- State Management: Zustand, Context API\n- Forms: React Hook Form\n- Testing: Vitest + Testing Library\n\n## Installation & Usage\n\n### Quick Start with npx (Recommended)\n\n```bash\n# Create project in a new directory\nnpx @daawoonkim/create-arch-app my-app\n\n# Or create in the current directory\nnpx @daawoonkim/create-arch-app .\n```\n\n### Global Installation\n\n```bash\nnpm install -g @daawoonkim/create-arch-app\n\n# Create project in a new directory\ncreate-arch-app my-app\n\n# Create in current directory\ncreate-arch-app .\n```\n\n> **Note**: When using current directory (`.`), the directory must be empty.\n\n### Interactive Prompts\n\nWhen you run the CLI, you'll answer these questions:\n\n1. **Framework**: React or Next.js\n2. **Next.js Version** (Next.js only): Latest (recommended), 15.x, 14.x, 13.x\n3. **Router** (Next.js only): App Router (recommended) or Pages Router\n4. **Architecture Pattern**: DDD, Clean, Atomic, Default\n5. **Styling**: Tailwind CSS or CSS Modules\n6. **State Management**: Zustand, Context API, None\n7. **Form Library**: React Hook Form or None\n8. **HTTP Client**: Axios, Fetch API, None\n9. **Data Fetching**: TanStack Query (React Query), SWR, None\n10. **Testing**: Include Vitest + Testing Library\n\n## Example Usage\n\n```bash\nnpx @daawoonkim/create-arch-app my-enterprise-app\n\n# Interactive prompts\n? Select framework: Next.js\n? Select Next.js version: Latest (Recommended)\n? Select Next.js router: App Router (Recommended)\n? Select architecture pattern: DDD (Domain-Driven Design)\n? Select styling tool: Tailwind CSS\n? Select state management: Zustand\n? Select form library: React Hook Form\n? Select HTTP client: Axios (Recommended)\n? Select data fetching library: TanStack Query (React Query) - Recommended\n? Include testing tools? Yes\n\nāœØ Creating project...\nšŸ“¦ Setting up TypeScript project (default)\nšŸš€ Using Next.js App Router\nāœ… Project created!\n\nšŸŽ‰ Project successfully created!\n\nGet started with:\n cd my-enterprise-app\n npm install\n npm run dev\n```\n\n## Architecture Patterns\n\n### DDD (Domain-Driven Design)\n\nPerfect for enterprise-grade applications.\n\n```\ndomain/ # Business entities and logic\n ā”œā”€ā”€ entities/\n ā”œā”€ā”€ repositories/\n ā””ā”€ā”€ services/\napplication/ # Use cases\n ā”œā”€ā”€ usecases/\n ā””ā”€ā”€ ports/\ninfrastructure/ # External service integration\n ā”œā”€ā”€ api/\n ā””ā”€ā”€ persistence/\npresentation/ # UI components\n ā”œā”€ā”€ components/\n ā””ā”€ā”€ pages/\n```\n\n### Clean Architecture\n\nFocuses on dependency rules and layer separation.\n\n```\ncore/ # Business logic\n ā”œā”€ā”€ entities/\n ā”œā”€ā”€ usecases/\n ā””ā”€ā”€ interfaces/\nfeatures/ # Feature modules\n ā””ā”€ā”€ [feature]/\n ā”œā”€ā”€ domain/\n ā”œā”€ā”€ data/\n ā””ā”€ā”€ presentation/\nshared/ # Shared components\n ā”œā”€ā”€ components/\n ā””ā”€ā”€ utils/\n```\n\n### Atomic Design\n\nOptimized for UI component-driven development.\n\n```\ncomponents/\n ā”œā”€ā”€ atoms/ # Smallest UI units\n ā”œā”€ā”€ molecules/ # Combinations of atoms\n ā”œā”€ā”€ organisms/ # Combinations of molecules\n ā”œā”€ā”€ templates/ # Page layouts\n ā””ā”€ā”€ pages/ # Actual pages\nhooks/\nutils/\n```\n\n### Default\n\nSimple structure for quick start.\n\n```\ncomponents/\nhooks/\npages/ (or app/)\nutils/\nstyles/\ntypes/\n```\n\n## Generated File Structure\n\n### React Project\n\n```\nmy-app/\nā”œā”€ā”€ src/\nā”‚ ā”œā”€ā”€ [architecture folders]\nā”‚ ā”œā”€ā”€ App.tsx\nā”‚ ā”œā”€ā”€ main.tsx\nā”‚ ā””ā”€ā”€ index.css\nā”œā”€ā”€ index.html\nā”œā”€ā”€ vite.config.ts\nā”œā”€ā”€ tsconfig.json\nā”œā”€ā”€ package.json\nā””ā”€ā”€ README.md\n```\n\n### Next.js Project (App Router)\n\n```\nmy-app/\nā”œā”€ā”€ src/\nā”‚ ā”œā”€ā”€ app/\nā”‚ ā”‚ ā”œā”€ā”€ layout.tsx\nā”‚ ā”‚ ā”œā”€ā”€ page.tsx\nā”‚ ā”‚ ā””ā”€ā”€ globals.css\nā”‚ ā””ā”€ā”€ [architecture folders]\nā”œā”€ā”€ next.config.js\nā”œā”€ā”€ tsconfig.json\nā”œā”€ā”€ package.json\nā””ā”€ā”€ README.md\n```\n\n### Next.js Project (Pages Router)\n\n```\nmy-app/\nā”œā”€ā”€ src/\nā”‚ ā”œā”€ā”€ pages/\nā”‚ ā”‚ ā”œā”€ā”€ _app.tsx\nā”‚ ā”‚ ā”œā”€ā”€ _document.tsx\nā”‚ ā”‚ ā””ā”€ā”€ index.tsx\nā”‚ ā”œā”€ā”€ styles/\nā”‚ ā”‚ ā””ā”€ā”€ globals.css\nā”‚ ā””ā”€ā”€ [architecture folders]\nā”œā”€ā”€ next.config.js\nā”œā”€ā”€ tsconfig.json\nā”œā”€ā”€ package.json\nā””ā”€ā”€ README.md\n```\n\n## Requirements\n\n- Node.js 18.0.0 or higher\n\n## Version History\n\n### v0.2.0 - Latest (2025-01-26)\n\n**Major Updates:**\n- āœ… API library integration (Axios, Fetch API, TanStack Query, SWR)\n- āœ… Architecture-specific API file generation\n- āœ… Improved Next.js project structure (`src/` directory + absolute paths)\n- āœ… CI/CD automation (GitHub Actions)\n- āœ… Automatic npm deployment on main branch merge\n- āœ… Enhanced documentation (CHANGELOG, CONTRIBUTING, WORKFLOWS)\n\nSee [CHANGELOG.md](./CHANGELOG.md) for details.\n\n### v0.1.0 - MVP Release\n\n**Features:**\n- āœ… 4 architecture patterns (DDD, Clean Architecture, Atomic Design, Default)\n- āœ… React (Vite) & Next.js (App Router / Pages Router) support\n- āœ… Next.js version selection (Latest, 15.x, 14.x, 13.x)\n- āœ… TypeScript by default\n- āœ… Styling: Tailwind CSS, CSS Modules\n- āœ… State Management: Zustand, Context API\n- āœ… Forms: React Hook Form\n- āœ… Testing: Vitest + Testing Library\n- āœ… Current directory creation support (`.` option)\n- āœ… Automatic folder structure and README generation\n\n## Roadmap\n\n### v0.3.0 (Planned)\n- [ ] Additional UI library integration (shadcn/ui, MUI)\n- [ ] More testing and stability improvements\n- [ ] Component generator\n\n### Future Plans\n- [ ] Additional architecture patterns (Feature-Sliced Design, Hexagonal Architecture)\n- [ ] More state management options (Redux Toolkit, Jotai, Recoil)\n- [ ] Authentication integration (NextAuth, Supabase)\n- [ ] ORM integration (Prisma, Drizzle)\n- [ ] Docker setup\n- [ ] Monorepo support (Turborepo)\n\n## Contributing\n\nBug reports, feature suggestions, and PRs are welcome!\n\nSee [CONTRIBUTING.md](./CONTRIBUTING.md) for details.\n\n## License\n\nMIT\n\n## Author\n\ndaawoonkim\n\n## Credits\n\nThis project is based on modern frontend development best practices and various architectural patterns.\n","readmeFilename":"README.md"}