saleor/storefront

Saleor 기반 헤드리스 이커머스를 위한 프로덕션 레디 Next.js 스토어프론트 템플릿

템플릿확인 필요 · NOASSERTION커머스·결제TypeScript난이도
1,469+4이번 주0 찜
842포크4이슈
데모·홈페이지 열기storefront.saleor.io

중간맛 분석

스택: Next.js 16 + React 19 + TypeScript + Tailwind CSS + GraphQL Codegen 난이도: 2–3 (기본 Saleor 지식 필요) 바로 쓸 수 있나? 네. Saleor Cloud 계정만 있으면 5분 내 로컬에서 전체 스토어 실행 가능 데모: https://storefront.saleor.io/

주요 기능: (1) 체크아웃 v2—서버 컴포넌트 + 서버 액션으로 URL 기반 스텝 관리; (2) 국제화—/{locale}/{channel}/ 라우팅으로 한 번에 다국가 대응; (3) 부분 사전 렌더링(PPR)—제품 페이지는 정적 쉘을 캐시하고 갤러리만 스트리밍; (4) AI 에이전트 대응—21개의 구조화된 스킬 규칙과 AGENTS.md로 AI 코드어시스턴트 지원.

이런 레포예요

이럴 때 쓰면 좋아요

  • 다국가·다채널 B2C 이커머스 스토어를 빠르게 구축하고 싶을 때
  • Saleor를 백엔드로 하는 성능 최적화된 쇼핑몰이 필요할 때
  • AI 코딩 어시스턴트(Cursor, Claude)와 협업하며 스토어프론트을 개발하고 싶을 때

핵심 기능

Checkout v2: 서버 컴포넌트 + 서버 액션 기반 멀티스텝 결제 플로우국제화: `/{locale}/{channel}/` 라우팅과 3층 문자열 시스템(Saleor 번역 + CMS + 코드)Partial Prerendering: 정적 쉘 + 동적 스트리밍으로 빠른 로딩과 실시간 데이터 동시 달성

대안 대비 차별점

Saleor 공식 템플릿으로 Cache Components를 활용한 Display-Cached/Checkout-Live 아키텍처와 Saleor Cloud 인프라(웹훅 앱, 대시보드 Preview)의 긴밀한 연동, 그리고 AI 에이전트 대응 21개 구조화된 스킬로 단순 템플릿을 넘어 엔터프라이즈급 협업 플랫폼을 제공합니다.

준비물

  • Saleor Cloud 계정 또는 자체 호스팅 Saleor 인스턴스
  • Node.js (최신 LTS 버전 권장)
  • pnpm 패키지 매니저

바로 시작하기

  1. Saleor CLI로 클론 및 초기화
npm i -g @saleor/cli@latest
saleor storefront create --url https://{YOUR_INSTANCE}/graphql/
  1. 또는 수동으로 클론 후 의존성 설치
git clone https://github.com/saleor/storefront.git
cd storefront
cp .env.example .env
pnpm install
  1. .env 파일에 Saleor 정보 입력
NEXT_PUBLIC_SALEOR_API_URL=https://your-instance.saleor.cloud/graphql/
NEXT_PUBLIC_DEFAULT_CHANNEL=default-channel
  1. 다국가 설정 (선택)
STOREFRONT_CHANNELS=us,uk,eu
NEXT_PUBLIC_STOREFRONT_LOCALES=en,pl,de,fr,fi,nb
  1. 개발 서버 실행
pnpm dev
  1. 브라우저에서 http://localhost:3000 접속

별 추이 · 7일

1,469+4 / 7일

활용성 · 따라 만들기 좋은가

샘플 점수 26/100
  • 관대한 라이선스
  • 테스트 있음
  • 예제 디렉토리
  • 최근 활동
  • AGENTS.md
  • llms.txt
  • 템플릿

🟢 최근 활동 있음 · 2021년 생성

이 레포에 깃밥 배지 달기

[![깃밥](https://www.gitbap.com/badge/saleor/storefront.svg)](https://www.gitbap.com/r/saleor/storefront)

🔌 클로드에서 바로 써보기

깃밥을 클로드에 연결하면 이런 레포를 클로드·커서·Codex에서 바로 찾고 체험할 수 있어요.

방법 ① 커넥터 URL

클로드 설정 → 커넥터에 이 주소를 붙여넣기.

https://www.gitbap.com/api/mcp
방법 ② 플러그인 (체험까지)

플러그인을 설치하면 /gitbap-trending·/gitbap-try 슬래시 커맨드로 레포를 그 자리에서 체험. Claude Code에서 아래 두 줄을 차례로 실행하세요.

/plugin marketplace add jakeparkcolde/gitbap-cowork
/plugin install gitbap-cowork@gitbap
연결 방법 자세히 →

AI가 README 기반으로 요약했습니다 · 원문 보기