create-jjlabs-app

jjlabsio-starter 템플릿으로 새 프로젝트를 생성하는 CLI 도구.

Usage

npx create-jjlabs-app my-app

프로젝트 이름을 생략하면 대화형으로 입력받습니다:

npx create-jjlabs-app

Options

-h, --help      도움말 표시
-v, --version   버전 표시

Scaffold Flow

1. Copy — CLI 패키지에 내장된 template/을 프로젝트 경로로 복사
2. Layout 선택 — Sidebar 또는 Standard 레이아웃 선택, 미사용 레이아웃의 route group·domain 디렉토리 제거
3. Auth 정리 — 선택한 레이아웃의 layout.tsx에서 중복 auth guard 제거 (상위 (authenticated)/layout.tsx가 담당)
4. Redirect 업데이트 — Standard 선택 시 루트·sign-in 리다이렉트 경로를 /dashboard → /home으로 변경
5. 패키지 이름 업데이트 — root 및 apps/app의 package.json 이름 치환
6. Serena 설정 초기화 — .serena/project.yml의 project_name 갱신
7. 플레이스홀더 치환 — {{PROJECT_NAME}}을 실제 프로젝트명으로 일괄 치환
8. 마무리 — .git 제거, .env.example → .env 복사, pnpm install 실행

Layout Options

| Layout | Description | | ------------ | ------------------------------------- | | Sidebar | 대시보드 스타일의 사이드바 네비게이션 | | Standard | 헤더 + 푸터 레이아웃 |

Development

pnpm install
pnpm dev              # tsx로 직접 실행 (tsx src/index.ts)
pnpm build            # tsup으로 dist/ 빌드
pnpm test             # vitest 테스트 실행
pnpm test:watch       # 감시 모드
pnpm typecheck        # 타입 체크

템플릿 위치

템플릿 파일은 template/에 위치. npm 배포 시 dist/와 함께 패키지에 포함됨 (files: ["dist", "template"]).

로컬 E2E 테스트:

pnpm build
node dist/index.js test-project
cd test-project && pnpm dev

템플릿 빌드 제한

(sidebar)와 (standard) 양쪽이 /settings/billing 등 동일 경로를 정의하므로 템플릿 자체는 빌드되지 않음. 의도된 설계 — scaffold 후 미사용 레이아웃이 제거되면 충돌 해소.

Publishing

pnpm publish:npm