빠른 시작

5분 정도 걸립니다. Node.js 18 이상과 Shoal 계정이 필요합니다.

프로젝트 만들기

대시보드에서 새 프로젝트를 누르고 이름을 정하세요. Shoal이 development와 production 두 환경을 만들고, 환경마다 SDK 키를 발급합니다.

SDK 설치

Terminal

npm install @shoal/sdk

Terminal

pnpm add @shoal/sdk

Terminal

yarn add @shoal/sdk

Terminal

bun add @shoal/sdk

키 추가

프로젝트 설정 → 키에서 development의 서버 키를 복사해 환경 변수에 넣습니다.
.env.local
```
SHOAL_KEY=sk_dev_7f3a9c1e5b2d
```

플래그 만들기

대시보드에서 new-checkout이라는 불리언 플래그를 만들거나 터미널에서 실행합니다.

Terminal

npx shoal flags create new-checkout --type boolean

Terminal

pnpm dlx shoal flags create new-checkout --type boolean

Terminal

yarn dlx shoal flags create new-checkout --type boolean

Terminal

bunx shoal flags create new-checkout --type boolean

평가하기

checkout.ts

import { createClient } from "@shoal/sdk";

const shoal = createClient({ key: process.env.SHOAL_KEY! });

export async function checkoutVariant(userId: string) {
  const on = await shoal.isOn("new-checkout", { user: { id: userId } });
  return on ? "new" : "classic";
}

대시보드에서 플래그를 켜고 함수를 다시 호출해 보세요. 재시작 없이 결과가 바뀝니다.

다음 단계

타기팅 규칙특정 사용자, 요금제, 국가에만 플래그를 켜세요.점진적 출시1%, 10%, 50%로 늘려 가며 지표를 확인하세요.