cob create

Mason 브릭으로 새 프로젝트 생성

cob create#

Mason 브릭으로 새 모노레포 프로젝트를 생성합니다. 모든 옵션을 프롬프트로 입력받는 Interactive 모드와 플래그로 전달하는 Non-interactive 모드를 지원합니다.

cob create --type monorepo [options]

--type app은 아직 구현되지 않았습니다 (App creation is not yet implemented).

실행 모드#

Interactive 모드 (권장)#

옵션을 생략하면 항목별 프롬프트로 값을 입력받습니다. 기본값이 제시되므로 Enter만 눌러 진행할 수 있습니다.

cob create --type monorepo

미지정 옵션은 모두 프롬프트로 수집 (프로젝트명, 조직, 도메인, GitHub, 인증서 등)
Feature 모듈은 항목별 포함 여부를 개별 확인
생성 완료 후 GitHub 레포 생성 여부와 make start 실행 여부를 추가로 확인

Non-interactive 모드#

--no-interactive 지정 시 프롬프트 없이 플래그 값과 기본값만 사용합니다. --name은 필수입니다.

cob create --type monorepo --no-interactive --name my_app

옵션#

프로젝트 옵션#

옵션	축약	설명	기본값
`--type`	`-t`	프로젝트 타입 (`monorepo`, `app`)	`monorepo`
`--name`	`-n`	프로젝트명 (snake_case, non-interactive 필수)	-
`--description`	`-d`	프로젝트 설명	`A new monorepo project`
`--output-dir`	`-o`	출력 디렉토리	`.`
`--organization`		조직/회사명	프로젝트명 Title Case
`--backend`		백엔드 타입 ( `openapi` , `serverpod` , `graphql` , `supabase` , `firebase` )	`serverpod`
`--features`		포함할 feature 모듈 (쉼표 구분)	기본 세트
`--enable-admin`		관리자 콘솔 활성화 (`true`/`false` 값 필요)	`true`
`--console-skeleton`		admin=true일 때 도메인 console 기능 제외, 빈 어드민 셸만 생성	`false`
`--no-interactive`		비대화형 모드	interactive가 기본
`--auto-start`		생성 후 `make start` 자동 실행	`false`
`--save-config`		설정을 `projects/`에 JSON으로 저장	`false`

--console-skeleton은 --enable-admin false이면 무시됩니다(강제 false). Interactive 모드에서는 admin 활성화 시 프롬프트로 확인합니다.

GitHub 옵션#

옵션	설명	기본값
`--github-org`	GitHub 조직명	`coco-de`
`--github-repo`	GitHub 레포명	프로젝트명 (kebab-case)
`--github-visibility`	레포 공개 범위 (`private`, `public`)	`private`
`--create-repo`	프로젝트 생성 후 GitHub 레포 자동 생성	`false`

도메인/인증서 옵션#

옵션	설명	기본값
`--tld`	도메인 TLD suffix (예: `studio` → cocode.studio)	`im`
`--subdomain`	서브도메인 prefix (예: `cocode` → cocode.studio)	프로젝트명 (kebab-case)
`--org-tld`	조직 TLD	`com`
`--admin-email`	관리자 이메일	`dev@{프로젝트명}.{tld}`
`--cert-cn`	인증서 Common Name	조직명
`--cert-ou`	인증서 Organizational Unit	`Production`
`--cert-o`	인증서 Organization	조직명
`--cert-l`	인증서 Locality/City	`Seoul`
`--cert-st`	인증서 State/Province	`Seoul`
`--cert-c`	인증서 국가 코드 (2자리)	`KR`

Apple 옵션#

옵션	설명	기본값
`--apple-developer-id`	Apple Developer ID (이메일)	-
`--itc-team-id`	App Store Connect Team ID	-
`--team-id`	Developer Portal Team ID	-

AWS 옵션#

옵션	설명	기본값
`--aws-access-key-id`	AWS Access Key ID (S3, SNS, SQS)	-
`--aws-secret-access-key`	AWS Secret Access Key	-

random_project_id는 옵션 없이 자동 생성됩니다 (영문 소문자+숫자 4자리).

Feature 선택#

기본 Feature 세트#

--features 미지정 시 기본 포함:

app_router, dashboard, home, mypage, notification, onboarding

전체 Feature 목록#

app_router, attendance, classroom, community, dashboard, home,
homework, league, level_test, management, mypage, notice_board,
notification, onboarding, payment, report, review, schedule,
store, study_material, users

Feature 의존성#

의존 feature가 선택되지 않으면 경고 후 자동 추가됩니다.

Feature	의존 Feature
`payment`, `report`, `management`, `league`	`users`
`homework`, `attendance`	`classroom`
`review`	`store`

예시#

# Interactive 모드 (권장)
cob create --type monorepo

# Non-interactive 모드 (전체 옵션)
cob create --type monorepo --no-interactive \
  --name good_teacher \
  --description "Good Teacher App" \
  --organization laputa \
  --tld im --org-tld im \
  --github-org coco-de --github-repo good-teacher \
  --github-visibility private \
  --backend serverpod \
  --enable-admin true --admin-email tech@laputa.im \
  --apple-developer-id tech@laputa.im \
  --itc-team-id 127782534 --team-id Y7BR9G2CVC \
  --cert-cn Laputa --cert-ou Production --cert-o "Laputa Inc." \
  --cert-l Seoul --cert-st Mapo --cert-c KR

# Feature 목록 지정 + GitHub 레포 자동 생성
cob create --type monorepo --no-interactive \
  --name my_app \
  --features home,community,notification,payment \
  --create-repo

# 설정 저장 (이후 create-from-config로 재사용)
cob create --type monorepo --no-interactive \
  --name blueprint --organization Cocode \
  --save-config

GitHub 레포 자동 생성#

--create-repo 플래그를 추가하면 프로젝트 생성 후 GitHub 레포를 자동 생성합니다. Interactive 모드에서는 플래그가 없어도 생성 여부를 프롬프트로 확인합니다.

실행 순서:

gh CLI 설치 및 인증 상태 확인
git init → git add . → git commit -m "Initial commit"
gh repo create {org}/{repo} --{visibility} 후 push

gh CLI가 없거나 인증되지 않은 경우 경고만 출력하고 건너뛰며, 프로젝트 생성 자체는 실패하지 않습니다. 레포 생성 실패 시에도 수동 실행 가능한 명령어를 안내합니다.

설정 저장 (--save-config)#

--save-config 지정 시 수집된 모든 변수(프로젝트/GitHub/인증서/feature 등)를 projects/{프로젝트명}.json으로 저장합니다. 저장된 설정은 cob create-from-config로 재사용할 수 있습니다.