Configuration

seed-design.json 만들기

seed-design.json 파일은 CLI로 생성하거나 직접 추가할 수 있어요.

CLI로 seed-design을 추가하는 방법을 알아봐요.

아래 파일을 프로젝트 루트에 생성해주세요.

seed-design.json

{
  "rsc": false,
  "tsx": true,
  "path": "./seed-design",
  "telemetry": true
}

seed-design.json

{
  "rsc": false,
  "tsx": true,
  "path": "./seed-design",
  "telemetry": true
}

seed-design.json은 엄격하게 파싱돼요. 문서에 없는 키를 임의로 추가하면 CLI 실행 시 오류가 날 수 있어요.

옵션	타입	기본값	설명
`path`	`string`	없음 (init에서는 `./seed-design`)	스니펫이 생성될 루트 경로
`rsc`	`boolean`	`false`	React Server Components 사용 여부에 맞춰 `"use client"` 유지/제거
`tsx`	`boolean`	`true`	생성 파일을 TypeScript(`.ts/.tsx`) 또는 JavaScript(`.js/.jsx`)로 변환
`telemetry`	`boolean`	`true`	익명 사용 데이터 수집 여부
`$schema`	`string`	선택값	JSON 스키마 힌트용 필드 (CLI 동작에는 영향 없음)

path는 스니펫이 생성되는 루트 디렉토리예요.

add/add-all 실행 시 파일은 path 아래에 레지스트리 ID와 스니펫 내부 경로 기준으로 생성돼요. 고정된 폴더 구조가 아니라, 선택한 항목에 따라 구조가 달라져요.

seed-design.json

{
  "path": "./seed-design"
}

action-button.tsx

tabs.tsx

animate-number.tsx

classnames.ts

React Server Components를 사용할지 설정해요.

스니펫에 이미 있는 "use client" directive를 유지할지 결정해요.

seed-design.json

{
  "rsc": true | false // default: false
}

TypeScript를 사용할지 설정해요.

false로 설정하면 .ts/.tsx 파일이 .js/.jsx로 변환돼요.

seed-design.json

{
  "tsx": true | false // default: true
}

텔레메트리 데이터 수집 여부를 설정해요.

SEED Design CLI는 개선을 위해 익명 사용 데이터를 수집해요. 프로젝트 경로, 파일 내용, 소스 코드는 수집하지 않아요.

seed-design.json

{
  "telemetry": true | false // default: true
}

아래 순서로 텔레메트리 활성화 여부를 판단해요.

1. seed-design.json 설정

{
  "telemetry": false
}

2. 환경 변수 설정

export DISABLE_TELEMETRY=true
# 또는
export SEED_DISABLE_TELEMETRY=true

$schema는 선택적으로 추가할 수 있는 문자열 필드예요. 현재 CLI 동작에는 영향을 주지 않고, 에디터의 JSON 자동완성/검증 용도로만 사용할 수 있어요.