#프로젝트 셋업

이 가이드는 템플릿으로 새 프로젝트를 만든 뒤 실제 운영 가능한 상태까지 셋업하는 전체 흐름을 다룹니다.

#사전 준비

Node.js LTS 18 이상
Yarn (yarn.lock 사용)

#1. 템플릿으로 저장소 생성

GitHub에서 Use this template를 클릭합니다.
본인 저장소를 생성합니다.
로컬로 클론합니다.

#2. 의존성 설치

yarn install

#3. 환경 변수 설정

.env.local.example을 .env.local로 복사한 뒤 값을 설정합니다.

NEXT_PUBLIC_SITE_URL=http://localhost:3000
GOOGLE_INDEXING_URL=https://your-domain.com
NEXT_PUBLIC_GOOGLE_SITE_VERIFICATION=YOUR_GOOGLE_SITE_VERIFICATION_CODE

참고:

NEXT_PUBLIC_SITE_URL: canonical URL, sitemap, metadata 생성에 사용
GOOGLE_INDEXING_URL: Google 인덱싱 스크립트 대상 도메인
NEXT_PUBLIC_GOOGLE_SITE_VERIFICATION: Search Console 인증 메타 태그

#4. 스타터 콘텐츠 복사

cp -r examples/public/* public/

복사 후 아래를 수정하세요.

public/products/[slug]/: 프로덕트 설정, 로케일, 스크린샷, 법적 문서, 아이콘
public/site/: 개발자 소개 및 사이트 공통 데이터

#5. 로컬 실행

yarn dev

#6. 빌드 및 프리뷰

yarn build
yarn start

#7. 배포

Next.js 빌드 결과물은 정적 출력(out/)으로 생성됩니다.
Vercel 또는 정적 호스팅(Netlify, S3/CloudFront, Cloudflare Pages)에 배포할 수 있습니다.

#8. 배포 후 핵심 라우트 확인

/{locale}
/{locale}/{product}
/{defaultLocale}/{product}/privacy-policy
/{defaultLocale}/{product}/terms-of-use
/{locale}/blogs

#9. 선택 사항: MCP 설정

Pabal Store API MCP: Configure Credentials
Pabal Resource MCP: init-project로 로컬 ASO/public 데이터 초기화

#10. 업스트림 템플릿 동기화

git remote add upstream https://github.com/quartz-labs-dev/pabal-web.git
git fetch upstream
git merge upstream/main --allow-unrelated-histories
git push origin main

Getting Started Blog