spree/spree-starter
Docker 기반 Spree Commerce 백엔드 스타터 프로젝트로 온라인 스토어를 빠르게 시작하세요
399+1이번 주0 찜
257포크1이슈
중간맛 분석
Ruby on Rails 기반의 Spree Commerce 백엔드입니다. Compose로 모든 의존성(PostgreSQL, Redis, Meilisearch)을 격리된 환경에서 관리하므로 호스트에 Ruby나 데이터베이스를 설치할 필요가 없습니다. 소스 코드 변경 시 즉시 반영되는 핫 리로드, 관리자 대시보드(admin), REST (//v3/store), 작업 큐(Sidekiq) 등을 내장하고 있습니다. 바로 쓸 수 있으며, 공식 문서의 커스터마이징 가이드로 확장 가능합니다.
이런 레포예요
이럴 때 쓰면 좋아요
- 소매 온라인 스토어 백엔드를 빠르게 구축하고 싶을 때
- Headless 아키텍처로 별도의 프론트엔드(Next.js 등)와 연결할 때
- 기존 Spree 기능을 확장하여 맞춤 전자상거래 플랫폼을 만들 때
핵심 기능
Docker 기반 개발 환경(Ruby, PostgreSQL, Redis 자동 설정)관리자 대시보드와 Store API 포함핫 리로드로 즉각적인 피드백
대안 대비 차별점
표준 Spree 프레임워크를 Docker로 완전히 격리하여 초기 설정 시간을 대폭 줄이고, create-spree-app과의 통합으로 풀스택 구성 또는 백엔드 독립 운영을 모두 지원합니다.
준비물
- Docker 또는 Docker Desktop
바로 시작하기
- 저장소를 클론하고 설정 파일을 준비합니다
git clone https://github.com/spree/spree-starter.git my-store
cd my-store
cp .env.example .env
- SECRET_KEY_BASE를 생성하여 .env 파일에 설정합니다
docker run --rm ruby:slim ruby -e 'require "securerandom"; puts SecureRandom.hex(64)'
(출력된 값을 .env의 SECRET_KEY_BASE에 붙여넣습니다)
- Docker Compose를 통해 개발 환경을 시작합니다
docker compose -f docker-compose.dev.yml up -d
- 데이터베이스를 준비하고 샘플 데이터를 로드합니다
docker compose -f docker-compose.dev.yml exec web bin/rails db:prepare db:seed
- 애플리케이션에 접속합니다 http://localhost:3000으로 이동하면 스토어에 접근할 수 있습니다. 관리자 대시보드는 http://localhost:3000/admin에서, API는 http://localhost:3000/api/v3/store/products에서 이용할 수 있습니다.
별 추이 · 7일
399+1 / 7일
활용성 · 따라 만들기 좋은가
따라 하기 좋음샘플 점수 54/100
- 관대한 라이선스
- 테스트 있음
- 예제 디렉토리
- 최근 활동
- AGENTS.md
- llms.txt
- 템플릿
🟢 최근 활동 있음 · 2015년 생성
이 레포에 깃밥 배지 달기
[](https://www.gitbap.com/r/spree/spree-starter)🔌 클로드에서 바로 써보기
깃밥을 클로드에 연결하면 이런 레포를 클로드·커서·Codex에서 바로 찾고 체험할 수 있어요.
방법 ① 커넥터 URL
클로드 설정 → 커넥터에 이 주소를 붙여넣기.
https://www.gitbap.com/api/mcp방법 ② 플러그인 (체험까지)
플러그인을 설치하면 /gitbap-trending·/gitbap-try 슬래시 커맨드로 레포를 그 자리에서 체험. Claude Code에서 아래 두 줄을 차례로 실행하세요.
/plugin marketplace add jakeparkcolde/gitbap-cowork/plugin install gitbap-cowork@gitbapAI가 README 기반으로 요약했습니다 · 원문 보기