create-ait-app

앱인토스(Apps in Toss) 프로젝트를 빠르게 시작할 수 있는 CLI 도구예요. Vite 기반 React 또는 Vanilla 프로젝트를 생성하고, 인앱결제·인앱광고 예제 등을 선택적으로 추가할 수 있어요.

Node.js 24 이상이 필요해요.

빠르게 시작하기

npx create-ait-app my-app
cd my-app
npm run dev

패키지 매니저는 생성 시 선택한 값에 맞게 yarn dev, pnpm dev 등으로 실행하면 돼요.

대화형 설정

npx create-ait-app my-app으로 실행하면 대화형으로 설정할 수 있어요. yarn create ait-app, npm create ait-app, pnpm create ait-app으로 실행해도 템플릿은 선택할 수 있어요. (호출한 패키지 매니저는 자동으로 사용해요.)

1. 패키지 매니저 — npm, yarn, pnpm
2. 프로젝트 템플릿 — react-ts / react / js / ts
3. AI Skills — Cursor / Claude Code / Codex용 SDK 문서 파일 추가 여부
4. 예제 코드 — 인앱결제(iap), 인앱광고(iaa) 샘플 추가 (복수 선택 가능)

CLI 옵션

프롬프트 없이 한 줄로 생성할 수도 있어요.

create-ait-app my-app --inline --pm yarn --sample iap,iaa

| 옵션 | 설명 | | --- | --- | | --inline | 대화형 질문을 생략하고 옵션만으로 설정해요 (미지정 항목은 모두 n이에요) | | --pm <name> | 패키지 매니저를 지정해요 (npm, yarn, pnpm) | | --template <name> | 템플릿을 지정해요 (js, ts, react, react-ts / 기본값: react-ts) | | --skills | AI를 위한 Skills 파일을 추가해요 | | --ai <name> | 사용할 AI 도구를 지정해요 (cursor, claude, codex) | | --sample <name> | 예제 코드를 추가해요 (iap, iaa / 복수: iap,iaa) | | --help | 도움말을 출력해요 |

기존 프로젝트에 예제 추가

프로젝트 생성 시 예제를 넣지 않았다면, 나중에 아래 명령으로 추가할 수 있어요.

create-ait-app add-sample iap
create-ait-app add-sample iap,iaa
create-ait-app add-sample ./my-app iap

프로젝트 디렉토리에서 실행하면 경로 생략이 가능해요.

생성되는 프로젝트

기본 템플릿은 헤더, 개발자센터·커뮤니티 링크 등 최소 구성만 포함해요. --sample로 예제를 선택한 경우 src/pages/가 추가되고, React 템플릿은 src/hooks/, Vanilla(js/ts) 템플릿은 src/lib/가 추가돼요.

선택 사항

TDS (Toss Design System)

TDS는 토스에서 제공하는 디자인 시스템 컴포넌트 모음이에요. 앱인토스 개발에 필수는 아니에요. 기본 생성 흐름에는 포함되지 않아요.

TDS를 쓰려면 react-ts 템플릿과 함께 --tds 옵션을 명시적으로 지정해 주세요.

create-ait-app my-app --inline --template react-ts --tds

대화형으로 생성할 때는 react-ts 템플릿을 선택한 경우에만 TDS 사용 여부를 물어봐요 (기본값: 사용 안 함).

관련 링크

• 앱인토스 콘솔
• 앱인토스 개발자센터
• 앱인토스 개발자 커뮤니티
• AI를 위한 LLMs 문서

이 CLI 도구에 기여하고 싶다면 CONTRIBUTING.md를 참고해 주세요.