웹사이트 빌더
워크플로
1. 프로젝트 평가
프로젝트 유형을 결정하고 스택을 선택합니다:
| 신호 | 스택 | 배포 |
|---|---|---|
| 마케팅 사이트, 포트폴리오, 간단한 페이지 | Vanilla HTML/CSS/JS 또는 Astro | Netlify |
| 인증, API, 데이터베이스가 있는 동적 앱 | Next.js + Tailwind | Vercel |
| Shopify 스토어 페이지(상품, 컬렉션, 홈페이지) | Liquid + JSON 템플릿 | Shopify API |
| 콘텐츠 중심 블로그/문서 | Astro + MDX | Netlify |
자세한 스택 선택 기준은 references/stack_guide.md를 참조하세요.
2. 디자인 시스템 구축
컴포넌트를 작성하기 전에 디자인 토큰을 정의합니다:
색상: primary, secondary, accent, neutral (50-900), success, error
타이포그래피: 제목 글꼴, 본문 글꼴, 스케일 (xs ~ 4xl)
간격: 4px 기본 단위 (4, 8, 12, 16, 24, 32, 48, 64)
모서리: sm (4px), md (8px), lg (12px), full
그림자: sm, md, lg
브랜드 자산(로고, 색상, 글꼴)을 모든 컴포넌트에 일관되게 적용합니다. 팔레트 구성 패턴은 references/design_tokens.md를 참조하세요. 웰니스/이커머스 디자인 영감(Serene Herbs, Magic Mind 스타일)은 references/design_inspiration.md를 참조하세요.
3. 컴포넌트 구축
정적 사이트: 섹션별로 모바일 우선으로 구축합니다. 각 섹션은 자체 스타일을 가진 독립적인 단위입니다.
React/Next.js 앱: 컴포넌트 우선 아키텍처. atoms → molecules → organisms → pages 순서로 구축합니다.
Shopify 테마: 테마 커스터마이저에서 편집 가능한 {% schema %} 블록이 있는 Liquid 섹션으로 구축합니다. Shopify 특화 패턴, 주의사항 및 배포에 대해서는 references/shopify_2_0.md를 참조하세요.
4. 배포
Netlify (정적 사이트):
npx netlify-cli deploy --prod --dir=./dist
Shopify (Liquid 섹션 + JSON 템플릿): 번들 스크립트를 사용하여 Admin API를 통해 푸시합니다:
scripts/deploy_shopify_section.py—.liquid섹션 파일 푸시scripts/deploy_shopify_template.py— JSON 템플릿 푸시 + 상품 할당
Vercel (Next.js):
npx vercel --prod
배포 세부 사항 및 안전 패턴은 references/deployment.md를 참조하세요.
Shopify 빠른 참조
Shopify는 가장 오류가 발생하기 쉬운 스택입니다. 주요 주의사항:
- 블록 타입 — 테마의 실제 블록 타입 이름을 사용하세요 (예:
title이지@app/title이 아닙니다) - 리치텍스트 필드 — HTML 태그에
style속성을 사용하지 않습니다. 시맨틱 HTML만 허용됩니다 - 컬러 스킴 —
scheme-1부터scheme-5까지 이름이 지정됩니다 (background-1이 아닙니다) - image-with-text — 콘텐츠는 섹션 수준 설정이 아닌 블록(제목, 텍스트, 버튼)을 사용합니다
- template_suffix 안전성 — 접미사를 변경하면 모든 테마에 영향을 미칩니다. 항상 먼저 라이브 테마에 fallback 템플릿을 푸시하세요
- Rate limiting — API 호출 사이에
time.sleep(0.5)를 추가하세요
예제가 포함된 전체 Shopify 참조: references/shopify_2_0.md