README

Website · Next.js Storefront · Demo · Documentation · API · Roadmap · Discord

Open-source headless eCommerce platform with a complete REST API, TypeScript SDK, and a production-ready Next.js storefront. BSD 3-Clause licensed — keep full ownership of your code, data, and infrastructure.

Everything you need to launch cross-border storefronts, B2B wholesale, or a custom commerce backend.

Getting Started

Copy and paste the following command to your terminal to set up Spree in 5 minutes:

npx create-spree-app@latest my-store

This sets up the Spree Commerce backend, the Admin Dashboard, and the Next.js storefront in a single project. The storefront is built with Next.js 16, React 19, Tailwind CSS 4, and TypeScript.

You need to have Node.js (22+) installed and Docker running. Learn more in the installation docs.

If you like what you see, consider giving Spree a GitHub star ⭐

Thank you for supporting Spree open-source ❤️

Agentic Development

Building with an AI coding agent? Install the Spree agent skills — they teach Claude Code, Cursor, Copilot, and 60+ other tools Spree's conventions, customization patterns, and upgrade flows:

npx skills add spree/agent-skills

Then connect the docs MCP server and let your agent build with you. Learn more in the Agentic Development docs.

Spree CLI

@spree/cli manages your Spree project from the terminal — boot the stack, run generators and migrations, tail logs — and calls the Admin API directly with simple get/post/patch/delete commands. It's a fast way to inspect and script your store, and works hands-free for AI agents (zero-config credentials in local dev):

spree dev                                                            # boot the project (web + worker + db)
spree generate api_resource Brand name:string description:rich_text  #  Creates full API endpoints, models and database schema for a Brand resource
spree api get /orders -q status_eq=complete --limit 10               # query the Admin API
spree api post /products -d '{"name":"Classic Tee","prices":[{"currency":"USD","amount":"29.99"}]}'  # create resources

spree api endpoints and spree api schema explore the full API offline. See the CLI docs.

Features

Everything below ships in this repository under the BSD 3-Clause license.

• REST API & TypeScript SDK — production-grade REST API, publishable keys, rate limiting, and OpenAPI 3.0 spec. The TypeScript SDK adds autocomplete and type safety.
• Spree CLI — manage projects from the terminal (boot, generate, migrate, upgrade) and call the Admin API directly with spree api get/post/... — zero-config in local dev, built for scripts and AI agents.
• Next.js Storefront — open-source storefront built with Next.js 16, React 19, Tailwind CSS 4, and TypeScript. Full shopping experience, multi-region URL routing, Stripe payments (Apple Pay, Google Pay, Klarna, Affirm), customer accounts, and SEO built in. Try the demo
• Cross-Border Commerce — Markets bundle currency, language, payment methods, and shipping rules per country. Translations Center for bulk product localization. EU Omnibus Directive compliance with automatic 30-day price history.
• B2B & Wholesale — Price Lists for regional, B2B, and wholesale pricing. Customer Groups for segmentation. Companies, company locations, and company contacts for buyer organizations. Catalogs for curated, per-segment product assortments. Gated storefronts via publishable keys.
• Sales Channels — run multiple storefronts, Points of Sale, B2B panels, mobile apps off a single Spree backend, each with its products, pricing, payment methods, and shipping rules
• Payment Sessions — provider-agnostic payment processing. Shipped with Stripe, Adyen and PayPal plugins ready to use with Next.js storefront. Add your own with the Payment Provider SDK.
• Promotions & Gift Cards — advanced rules-based promotions engine and native Gift Cards support.
• Products & Catalog — Metafields, CSV importer/exporter, digital products, product tags, bulk operations.
• MeiliSearch Integration — typo-tolerant product search and faceted filtering.
• Admin Dashboard — built with Tailwind CSS with role-based permissions.
• Integrations & Extensibility — Event Bus, Webhooks 2.0, native integrations (GA4, GTM, Klaviyo).
• Agentic Development — 25 agent skills (npx skills add spree/agent-skills) teaching AI coding agents Spree's conventions, a docs MCP server, LLM-ready documentation (llms.txt, per-page Markdown, offline npm package), and a generated AGENTS.md/CLAUDE.md in every scaffolded project.

Deployment

You can quickly deploy a Spree store with the button below, or follow our deployment guide for detailed instructions on deploying to various platforms.

Note This uses Render's free plan for quick evaluation. Free instances spin down after inactivity and may take 30-60s to wake up. For production, see recommended sizing.

Screenshots

Next.js eCommerce Storefront

A production-ready, open-source storefront built with Next.js 16, React 19, and TypeScript. Fork it, customize it, deploy it. Try the live demo

Cross-border eCommerce

Sell in multiple markets with local currencies, languages, payment methods, and shipping rules. Markets bundle per-country configuration so each customer sees a localized storefront from a single platform.

Wholesale & B2B Pricing

Price Lists, Customer Groups, and gated storefronts. Sell to multiple customer segments with the right assortment and pricing per segment.

Multi-vendor Marketplace

Launch a multi-vendor marketplace with vendor accounts, product catalog curation, split payments, vendor payouts, and commission management. The Enterprise Edition adds automated vendor onboarding (Shopify, WooCommerce sync) and Stripe Connect / Adyen for Platforms integrations.

Community & Contributing

Spree is an open-source project, and we love contributions in any form — pull requests, issues, feature ideas.

• Follow our Contributing Guide
• Join our Discord to meet other community members
• Browse the Roadmap and open Issues

Spree Enterprise Edition

Spree is built and maintained by a funded team behind the open-source project. Beyond the open-source Core, we offer a paid Enterprise Edition for organizations that need additional modules and SLA-backed support.

Enterprise Edition is built on top of the same open-source REST API and BSD 3-Clause Core, so your team keeps full ownership of the code, the data, and the infrastructure. Zero platform fees. Zero transaction fees.

What's in Core vs. Enterprise

Contact our Sales team for an Enterprise Edition demo, or join Discord to use the open-source edition with the community.

License

Spree Commerce core code in the spree/spree repository is released under the free, open-source BSD-3-Clause license (LICENSE).

If you like what you see, consider giving Spree a GitHub star ⭐

Thank you for supporting Spree open-source ❤️