Spree Setup

Before writing code

Fetch live docs:

1. Fetch https://spreecommerce.org/docs/developer/cli/quickstart for the current create-spree-app flags and Node/Ruby version requirements.
2. Fetch https://github.com/spree/spree-starter (README) for the Rails-backend starter setup.
3. Fetch https://github.com/spree/storefront (README) for the Next.js storefront prerequisites.
4. Web-search the latest release tag at https://github.com/spree/spree/releases — confirm the current minor version and matching spree-starter / storefront branch.
5. Check the v5.2 announcement (https://spreecommerce.org/announcing-spree-5-2/) for CLI changes if working on an older project.

Conceptual Architecture

Two Repos, One Project

A modern Spree project typically combines:

1. spree-starter (Rails 7+) — the backend application running the spree umbrella gem, admin, APIs, webhooks
2. storefront (Next.js 16+) — the headless storefront talking to the Rails backend over API v3