템플릿으로 빠르게 시작하기

미리 설정된 Airtable 템플릿을 복제하면 필드 구조와 샘플 데이터가 포함된 베이스를 바로 사용할 수 있습니다.

Airtable 템플릿 복제하기

TIP

복제 후 데이터를 수정하고 huh pull을 실행하세요.

---

1. Airtable 베이스/테이블 설정

새 베이스 만들기

1. Airtable에 로그인합니다.
2. Add a base → Start from scratch를 선택합니다.
3. 베이스 이름을 지정합니다 (예: Error Content).

필드(컬럼) 구조

테이블에 다음 필드를 생성합니다:

필드 이름	필드 타입	필수 여부	설명
trackId	Single line text	필수	에러 고유 식별자 (예: ERR_LOGIN_001)
type	Single select	필수	TOAST, MODAL, PAGE 또는 커스텀 타입
message	Long text	필수	에러 메시지. 형태로 템플릿 변수 사용 가능
title	Single line text	선택	에러 제목 (modal, page에서 사용)
image	URL 또는 Single line text	선택	에러 이미지 URL
severity	Single select	선택	INFO, WARNING, ERROR, CRITICAL 또는 커스텀 심각도
actionLabel	Single line text	선택	액션 버튼 텍스트
actionType	Single select	선택	REDIRECT, RETRY, BACK, DISMISS 또는 커스텀 액션
actionTarget	URL 또는 Single line text	선택	REDIRECT 시 이동할 URL

TIP

type 필드에 Single select 옵션으로 TOAST, MODAL, PAGE 등을 추가하면 입력 실수를 방지할 수 있습니다. severity (INFO, WARNING, ERROR, CRITICAL)와 actionType도 마찬가지입니다. 커스텀 타입도 옵션에 추가할 수 있습니다. 소문자로 입력해도 CLI가 자동으로 대문자로 변환합니다.

작성 예시

trackId	type	message	title	severity	actionLabel	actionType	actionTarget
ERR_LOGIN_001	TOAST	로그인에 실패했습니다. 다시 시도해주세요.		WARNING	재시도	RETRY
ERR_PAYMENT_001	MODAL	결제 처리 중 문제가 발생했습니다.	결제 오류	ERROR	고객센터 문의	REDIRECT	/support
ERR_NOT_FOUND	PAGE	요청하신 페이지를 찾을 수 없습니다.	페이지 없음	INFO	홈으로 가기	REDIRECT	/
ERR_NETWORK	TOAST	네트워크 연결을 확인해주세요.		WARNING	다시 시도	RETRY

2. Personal Access Token 발급

1. Airtable 토큰 페이지에 접속합니다.
2. Create new token을 클릭합니다.
3. 토큰 이름을 입력합니다 (예: huh-cli).
4. Scopes에서 data.records:read를 선택합니다.
5. Access에서 해당 베이스를 선택합니다.
6. Create token을 클릭하고 토큰을 복사합니다.

WARNING

토큰은 한 번만 표시됩니다. 안전한 곳에 보관하세요.

3. Base ID 및 Table ID 확인

1. Airtable에서 해당 베이스를 엽니다.
2. 브라우저 URL에서 확인합니다:

   https://airtable.com/appXXXXXXXXXXXXXX/tblYYYYYYYYYYYYYY/...
                        ^^^^^^^^^^^^^^^^^^^  ^^^^^^^^^^^^^^^^^^^
                        Base ID              Table ID

4. 설정

환경변수 설정 (권장)

.huh.config.json 예시

{
  "source": {
    "type": "airtable",
    "baseId": "appXXXXXXXXXXXXXX",
    "tableId": "tblYYYYYYYYYYYYYY"
  },
  "output": "./src/huh.json"
}

토큰을 config에 직접 지정하는 경우:

{
  "source": {
    "type": "airtable",
    "baseId": "appXXXXXXXXXXXXXX",
    "tableId": "tblYYYYYYYYYYYYYY",
    "token": "patXXXXXXXXXXXXXX"
  },
  "output": "./src/huh.json"
}

WARNING

config 파일에 토큰을 직접 넣는 경우, .gitignore에 .huh.config.json을 추가하세요.

5. 데이터 가져오기

정상적으로 실행되면 output 경로에 JSON 파일이 생성됩니다.