create-web-0to1

React, Next.js, monorepo preset을 하나의 인터랙티브 wizard로 생성하는 0to1 통합 생성기입니다.

사용법

가장 일반적인 실행 방식은 아래입니다.

npm create web-0to1@latest

또는

npx create-web-0to1@latest

실행 후 wizard에서 아래 preset 중 하나를 고르시면 됩니다.

• React standalone
• Next standalone
• Monorepo workspace

실행 방식은 아래처럼 최대한 단순하게 유지했습니다.

• standalone: 자동 scaffold 후 생성 또는 scaffolded dir에 적용
• monorepo: 바로 생성

standalone preset에서는 wizard 안에서 아래 옵션도 같이 고를 수 있습니다.

• Tailwind 포함 / No Style
• commitlint + husky 설정 여부
• docs/개발원칙 포함 여부

요구 사항

• Node.js >= 22.18
• upstream scaffold 실행용 네트워크 연결

로컬 개발

npm install
npm run create

검증:

npm run check
npm run smoke

문서 템플릿을 Git 기준으로 동기화하려면 아래처럼 실행합니다.

npm run sync:docs:git

동기화 필요 여부만 확인하려면 아래처럼 실행합니다.

npm run sync:docs:git -- --check

기본값은 frontend-principles 저장소의 main을 가져오며, 필요하면 아래처럼 ref를 지정할 수 있습니다.

FRONTEND_PRINCIPLES_REF=main npm run sync:docs:git

npm run release:prepare는 문서 sync, 검증, npm pack --dry-run까지 한 번에 실행하고, npm publish 전에는 같은 흐름이 자동으로 실행됩니다. 문서 repo의 최신 변경을 publish에 반영하려면, 해당 변경이 Git 원격에 먼저 push되어 있어야 합니다.

문서 위치

• 운영/인수인계: docs/HANDOFF.md
• 단계별 작업 로그: docs/steps/STEP31_COMPLETION_GATE.md부터 확인하시면 됩니다.

publish 메모

이 패키지는 npm publish 후 아래 형태로 실행되도록 맞춰져 있습니다.

npm create web-0to1@latest

npm create <name>는 내부적으로 create-<name> 패키지를 실행하므로, 패키지 이름은 create-web-0to1, bin 이름도 동일하게 설정되어 있습니다.