fireship-install

fireauto-fireship-install: FireShip Starter Kit 자동 설치

FireShip Starter Kit(FireShipZip3) 보일러플레이트를 자동으로 설치하고, docs/llm.md 온보딩 가이드에 따라 초기 설정까지 도와주는 커맨드예요.

• GitHub: https://github.com/imgompanda/FireShipZip3
• 데모: https://fire-ship-zip3.vercel.app

모든 출력은 **한국어(토스체)**로 작성해요.

---

Step 1: 설치 환경 확인

먼저 현재 환경을 확인하세요:

node --version
git --version

• Node.js 18 이상이 필요해요
• git이 설치되어 있어야 해요

환경이 준비되지 않았으면 사용자에게 설치 방법을 안내하세요.

---

Step 2: 프로젝트 이름 및 경로 결정

사용자에게 물어보세요:

프로젝트 이름을 정해주세요! (예: my-saas, my-app) 기본값: 현재 디렉토리에 FireShipZip3 이름으로 생성돼요.

사용자가 이름을 지정하면 그 이름으로, 아니면 기본값으로 진행해요.

---

Step 3: 보일러플레이트 클론

git clone https://github.com/imgompanda/FireShipZip3.git {프로젝트이름}
cd {프로젝트이름}

클론이 완료되면 git 히스토리를 초기화해요:

rm -rf .git
git init
git add -A
git commit -m "Initial commit from FireShip Starter Kit"

---

Step 4: 패키지 매니저 확인 및 의존성 설치

사용자에게 물어보세요:

어떤 패키지 매니저를 쓸까요? (npm / yarn / pnpm / bun) 기본값: npm

선택한 패키지 매니저로 설치해요:

# npm인 경우
npm install

# pnpm인 경우
pnpm install

# yarn인 경우
yarn install

# bun인 경우
bun install

---

Step 5: 환경 변수 설정

.env.example 파일을 .env.local로 복사해요:

cp .env.example .env.local

사용자에게 안내하세요:

.env.local 파일이 생성됐어요! 아래 키들을 설정해야 해요:

필수 (이것만 있으면 기본 동작해요)

• NEXT_PUBLIC_SUPABASE_URL — Supabase 프로젝트 URL
• NEXT_PUBLIC_SUPABASE_ANON_KEY — Supabase 공개 키
• SUPABASE_SERVICE_ROLE_KEY — Supabase 서비스 키

결제 연동 (3가지 중 택 1)

• NEXT_PUBLIC_PAYMENT_PROVIDER — 결제 프로바이더 선택 (lemon / paddle / toss, 기본: lemon)

• LemonSqueezy: LEMONSQUEEZY_API_KEY, LEMONSQUEEZY_WEBHOOK_SECRET

• Paddle: PADDLE_API_KEY, PADDLE_WEBHOOK_SECRET, PADDLE_ENVIRONMENT (sandbox/production)

• Toss: TOSS_SECRET_KEY, TOSS_CLIENT_KEY, TOSS_WEBHOOK_SECRET

이메일

• RESEND_API_KEY — Resend API 키

AI 기능

• GOOGLE_GENERATIVE_AI_API_KEY — Gemini API 키

각 서비스 설정 가이드는 docs/ 폴더에 있어요. 지금 바로 설정할 수도 있고, 나중에 해도 괜찮아요.

사용자가 키를 제공하면 .env.local 파일에 직접 입력해주세요. 제공하지 않으면 그냥 넘어가세요.