모든 Spree Commerce 6 프로젝트 뒤에 가로장 신청. 그것은 봉사합니다:

• Storefronts 및 모바일 앱용 Store API
• **Admin API **
• Admin 대시보드, /dashboard]
• background jobs, /jobs에서 대시보드와 함께
• 전환 이메일

create-spree-app]로 만든 프로젝트는 server/ 디렉토리에 이 응용 프로그램을 유지합니다.

시작하기

create-spree-app로 새로운 프로젝트를 만듭니다:

이 응용 프로그램을 함께 설정:

• 관리자 대시보드 및 마켓 플레이스에 대한 옵션 판매자 패널, 앱으로 사용자 정의 할 수 있습니다.
• 옵션 Next.js storefront
• Spree CLI, Docker의 모든 것을 실행
• AI 코딩 대리인을 위한 Spree 대리인 기술

Node.js와 Docker만 필요합니다.

그냥 evaluating spree? 자체 호스팅을 건너 호스팅 sandbox를 사용합니다.

사용자 정의

사용자 정의 가이드로 시작합니다. 그것은, 순서에서 당신은 그들을 위해 도달해야:

• 이벤트 및 가입자
• 워크플로우
• 신뢰성
• 확장
• 마지막 리조트로서의 장식자

Spree CLI를 통해 명령을 실행하고, bin/rails] 또는 bundle]를 직접 통해 절대로 하지 않습니다. 예를 들어, spree generate subscriber, spree migrate] 및 spree rspec].

코딩 에이전트

이름 *.

Spree Starter

The Rails application behind every Spree Commerce 6 project. It serves:

• the Store API for storefronts and mobile apps
• the Admin API
• the Admin Dashboard, at /dashboard
• background jobs, with their dashboard at /jobs
• transactional emails

Projects created with create-spree-app keep this application in their server/ directory.

Getting started

Create a new project with create-spree-app:

npx create-spree-app@latest my-store

It sets up this application together with:

• the Admin Dashboard and an optional Seller Panel for marketplaces, as apps you can customize
• an optional Next.js storefront
• the Spree CLI, which runs everything in Docker
• the Spree agent skills for AI coding agents

You only need Node.js and Docker.

Just evaluating Spree? Skip self-hosting and use a hosted sandbox.

Customization

Start with the Customization Guide. It covers, in the order you should reach for them:

• events and subscribers
• workflow hooks
• dependencies
• extensions
• decorators, as a last resort

Run commands through the Spree CLI, never through bin/rails or bundle directly. For example, spree generate subscriber, spree migrate and spree rspec.

Coding agents

AGENTS.md holds the instructions for coding agents such as Claude Code, Codex, Cursor and Copilot. CLAUDE.md imports it.

For deeper Spree knowledge, install the Spree agent skills:

npx skills add spree/agent-skills

Environment variables

.env.example lists the required variables. See the Environment Variables reference for the full list.

Deployment

This application builds into a single Docker image: the API, the Admin Dashboard and background jobs. render.yaml deploys it to Render.

See the Deployment Guide for Render, AWS and other Docker hosts.

License

MIT