---
title: "Spree Commerce for Developers | REST API, SDK, Docs, and CLI"
description: "Developer hub for Spree Commerce. REST API with OpenAPI 3.0 specs, TypeScript SDK, Next.js starter, CLI, and AI development tooling. Open source. Explore the docs, API reference, and community."
url: https://spreecommerce.org/spree-commerce-for-developers/
---

Developer Hub

# Spree Commerce for Developers

REST API, TypeScript SDK, and production-ready Next.js storefront. Self-host it. Own your stack. No vendor lock-in. Zero platform fees. Free Sandbox.

[Get started](https://spreecommerce.org/get-started/)[Contact us](https://spreecommerce.org/contact.md)

OR INSTALL LOCALLY

`npx create-spree-app@latest my-store`

[Not a developer or devops yourself?Talk to us about hiring a team for your project.](https://spreecommerce.org/contact.md)[Developer docsQuickstart, guides, and deployment](https://spreecommerce.org/docs/developer/getting-started/quickstart)[Spree IntegrationsUse these or build your own](https://spreecommerce.org/integrations.md)[Ecommerce APIREST API with OpenAPI 3.0 specs, TypeScript SDK](https://spreecommerce.org/docs/api-reference/store-api/introduction)[CustomizationExtensions, decorators, and custom logic](https://spreecommerce.org/docs/developer/customization/quickstart)[Spree FeaturesA quick visual overview](https://spreecommerce.org/features.md)[Spree Live DemoSee it in action](https://demo.spreecommerce.org/)[Spree Success StoriesThey speak for themselves](https://spreecommerce.org/success-stories.md)

## Stay in the loop

Join the community and learn how other people get the most out of Spree.

- Github15k+ stars
    
    Build any eCommerce solution that your business requires.
    
    [Explore](https://github.com/spree/spree#readme) 
- RubyGems2.5M downloads
    
    Trusted by thousands of developers version after version.
    
    [Explore](https://rubygems.org/gems/spree/) 

Blog

## Spree Commerce open-source

Check out these related posts for more insights and tips on the topic

- [Open-source Ecommerce](https://spreecommerce.org/category/open-source-ecommerce.md)February 2, 2026
    
    [Spree Commerce 5.3: Customer Groups — Segmentation for Personalized Commerce](https://spreecommerce.org/spree-commerce-5-3-customer-groups-segmentation-for-personalized-commerce.md)
    
    [Read more](https://spreecommerce.org/spree-commerce-5-3-customer-groups-segmentation-for-personalized-commerce.md) 
- [Open-source Ecommerce](https://spreecommerce.org/category/open-source-ecommerce.md)February 2, 2026
    
    [Spree Commerce 5.3: New Pricing Engine and Price Lists](https://spreecommerce.org/spree-commerce-5-3-new-pricing-engine-and-price-lists.md)
    
    [Read more](https://spreecommerce.org/spree-commerce-5-3-new-pricing-engine-and-price-lists.md) 
- [Open-source Ecommerce](https://spreecommerce.org/category/open-source-ecommerce.md)January 27, 2026
    
    [Announcing Spree Commerce 5.3](https://spreecommerce.org/announcing-spree-commerce-5-3-with-price-lists-customer-groups-new-admin-tools.md)
    
    [Read more](https://spreecommerce.org/announcing-spree-commerce-5-3-with-price-lists-customer-groups-new-admin-tools.md) 
- [Open-source Ecommerce](https://spreecommerce.org/category/open-source-ecommerce.md)December 19, 2025
    
    [Why VC-Funded Startups Need Source-Available, Self-Hosted eCommerce](https://spreecommerce.org/why-vc-funded-startups-need-source-available-self-hosted-ecommerce.md)
    
    [Read more](https://spreecommerce.org/why-vc-funded-startups-need-source-available-self-hosted-ecommerce.md) 
- [Open-source Ecommerce](https://spreecommerce.org/category/open-source-ecommerce.md)December 9, 2025
    
    [Metafields — Any Custom Attributes For eCommerce](https://spreecommerce.org/metafields-any-custom-attributes-without-developer-help.md)
    
    [Read more](https://spreecommerce.org/metafields-any-custom-attributes-without-developer-help.md) 
- [Open-source Ecommerce](https://spreecommerce.org/category/open-source-ecommerce.md)November 28, 2025
    
    [Announcing Spree 5.2](https://spreecommerce.org/announcing-spree-5-2.md)
    
    [Read more](https://spreecommerce.org/announcing-spree-5-2.md) 
- [Open-source Ecommerce](https://spreecommerce.org/category/open-source-ecommerce.md)October 21, 2025
    
    [Spree Commerce Open Source: 15,000 GitHub Stars and Counting](https://spreecommerce.org/spree-commerce-open-source-15000-github-stars.md)
    
    [Read more](https://spreecommerce.org/spree-commerce-open-source-15000-github-stars.md) 
- [Open-source Ecommerce](https://spreecommerce.org/category/open-source-ecommerce.md)October 6, 2025
    
    [Spree Commerce Community Reaches 7,000 Slack Members!](https://spreecommerce.org/spree-commerce-community-reaches-7000-slack-members.md)
    
    [Read more](https://spreecommerce.org/spree-commerce-community-reaches-7000-slack-members.md) 
- [Ecommerce AI](https://spreecommerce.org/category/ecommerce-ai.md)October 1, 2025
    
    [Spree Commerce Integration with ChatGPT Instant Checkout: Buy Directly through ChatGPT](https://spreecommerce.org/spree-commerce-integration-with-chatgpt-instant-checkout-buy-directly-through-chatgpt.md)
    
    [Read more](https://spreecommerce.org/spree-commerce-integration-with-chatgpt-instant-checkout-buy-directly-through-chatgpt.md) 
- [Spree Commerce](https://spreecommerce.org/category/open-source.md)June 27, 2025
    
    [🎉 Spree 5.1 with new Features and Integrations](https://spreecommerce.org/spree-5-1-with-new-features-and-integrations.md)
    
    [Read more](https://spreecommerce.org/spree-5-1-with-new-features-and-integrations.md) 
- [Spree Commerce](https://spreecommerce.org/category/open-source.md)June 11, 2025
    
    [📜 Spree Open-source eCommerce: Centralized Policy Pages for Legal Clarity & Brand Trust](https://spreecommerce.org/spree-open-source-ecommerce-centralized-policy-pages-for-legal-clarity-brand-trust.md)
    
    [Read more](https://spreecommerce.org/spree-open-source-ecommerce-centralized-policy-pages-for-legal-clarity-brand-trust.md) 
- [Spree Commerce](https://spreecommerce.org/category/open-source.md)June 11, 2025
    
    [🔐 Spree Open-source eCommerce: Password-Protected Storefronts for Privacy, Previews & Controlled Launches](https://spreecommerce.org/spree-open-source-ecommerce-password-protected-storefronts-for-privacy-previews-controlled-launches.md)
    
    [Read more](https://spreecommerce.org/spree-open-source-ecommerce-password-protected-storefronts-for-privacy-previews-controlled-launches.md) 
- [Spree Commerce](https://spreecommerce.org/category/open-source.md)June 11, 2025
    
    [📝 Spree Open-source eCommerce: Built-In Blog for Shoppable Content and SEO Wins](https://spreecommerce.org/spree-open-source-ecommerce-built-in-blog-for-shoppable-content-and-seo-wins.md)
    
    [Read more](https://spreecommerce.org/spree-open-source-ecommerce-built-in-blog-for-shoppable-content-and-seo-wins.md) 
- [Spree Commerce](https://spreecommerce.org/category/open-source.md)June 11, 2025
    
    [🔍 Spree Open-source eCommerce: Full-Text Search That Scales with Your Product Catalog](https://spreecommerce.org/spree-open-source-ecommerce-full-text-search-that-scales-with-your-product-catalog.md)
    
    [Read more](https://spreecommerce.org/spree-open-source-ecommerce-full-text-search-that-scales-with-your-product-catalog.md) 
- [Spree Commerce](https://spreecommerce.org/category/open-source.md)June 11, 2025
    
    [🧠 Spree Open-source eCommerce: Add Custom Code to Your Storefront Without Developers](https://spreecommerce.org/spree-open-source-ecommerce-add-custom-code-to-your-storefront-without-developers.md)
    
    [Read more](https://spreecommerce.org/spree-open-source-ecommerce-add-custom-code-to-your-storefront-without-developers.md) 

Blog

## Ecommerce AI

Check out these related posts for more insights and tips on the topic

- [Ecommerce AI](https://spreecommerce.org/category/ecommerce-ai.md)March 9, 2026
    
    [Commerce Is Infrastructure: What a Decade of Big Tech Failures Proves About Owning Your Platform](https://spreecommerce.org/commerce-is-infrastructure-what-a-decade-of-big-tech-failures-proves-about-owning-your-platform.md)
    
    [Read more](https://spreecommerce.org/commerce-is-infrastructure-what-a-decade-of-big-tech-failures-proves-about-owning-your-platform.md) 
- [Ecommerce AI](https://spreecommerce.org/category/ecommerce-ai.md)March 6, 2026
    
    [OpenAI Just Blinked: Nobody Seems to Want to Shop Inside ChatGPT](https://spreecommerce.org/openai-just-blinked-nobody-seems-to-want-to-shop-inside-chatgpt.md)
    
    [Read more](https://spreecommerce.org/openai-just-blinked-nobody-seems-to-want-to-shop-inside-chatgpt.md) 
- [Ecommerce AI](https://spreecommerce.org/category/ecommerce-ai.md)October 1, 2025
    
    [Spree Commerce Integration with ChatGPT Instant Checkout: Buy Directly through ChatGPT](https://spreecommerce.org/spree-commerce-integration-with-chatgpt-instant-checkout-buy-directly-through-chatgpt.md)
    
    [Read more](https://spreecommerce.org/spree-commerce-integration-with-chatgpt-instant-checkout-buy-directly-through-chatgpt.md) 
- [Ecommerce AI](https://spreecommerce.org/category/ecommerce-ai.md)September 25, 2024
    
    [Ecommerce AI: customer-facing and back-office applications](https://spreecommerce.org/ecommerce-ai-customer-facing-and-back-office-applications.md)
    
    [Read more](https://spreecommerce.org/ecommerce-ai-customer-facing-and-back-office-applications.md) 
- [Ecommerce AI](https://spreecommerce.org/category/ecommerce-ai.md)June 25, 2024
    
    [Customer-Facing Ecommerce AI](https://spreecommerce.org/customer-facing-ecommerce-ai.md)
    
    [Read more](https://spreecommerce.org/customer-facing-ecommerce-ai.md) 
- [Ecommerce AI](https://spreecommerce.org/category/ecommerce-ai.md)June 25, 2024
    
    [Back-Office Ecommerce AI](https://spreecommerce.org/back-office-ecommerce-ai.md)
    
    [Read more](https://spreecommerce.org/back-office-ecommerce-ai.md) 

Blog

## Next.js storefront

Check out these related posts for more insights and tips on the topic

- [Next.js eCommerce](https://spreecommerce.org/category/next-js-ecommerce.md)April 5, 2026
    
    [7 Real-World Next.js B2B eCommerce Websites From Staples to HashiCorp](https://spreecommerce.org/nextjs-b2b-ecommerce-storefronts.md)
    
    [Read more](https://spreecommerce.org/nextjs-b2b-ecommerce-storefronts.md) 
- [Multi-vendor Marketplace](https://spreecommerce.org/category/marketplace.md)April 3, 2026
    
    [14 Amazing Next.js Marketplace Websites From DoorDash to StockX](https://spreecommerce.org/nextjs-marketplace-ecommerce-platforms.md)
    
    [Read more](https://spreecommerce.org/nextjs-marketplace-ecommerce-platforms.md) 
- [Next.js eCommerce](https://spreecommerce.org/category/next-js-ecommerce.md)April 3, 2026
    
    [9 Amazing Next.js Fashion eCommerce Websites From Nike to Depop](https://spreecommerce.org/nextjs-fashion-ecommerce-storefronts.md)
    
    [Read more](https://spreecommerce.org/nextjs-fashion-ecommerce-storefronts.md) 
- [Headless Commerce](https://spreecommerce.org/category/headless-commerce.md)February 16, 2026
    
    [Spree Commerce API v3 & the Next.js Storefront Starter for Amazing Shopping Experiences](https://spreecommerce.org/spree-commerce-api-v3-the-next-js-storefront-starter-for-amazing-shopping-experiences.md)
    
    [Read more](https://spreecommerce.org/spree-commerce-api-v3-the-next-js-storefront-starter-for-amazing-shopping-experiences.md) 
- [Headless Commerce](https://spreecommerce.org/category/headless-commerce.md)February 13, 2026
    
    [AI-Aided In-House Development of Shopping Experiences Using Spree Open-Source eCommerce API and Next.js](https://spreecommerce.org/ai-aided-in-house-development-of-shopping-experiences-using-spree-open-source-ecommerce-api-and-next-js.md)
    
    [Read more](https://spreecommerce.org/ai-aided-in-house-development-of-shopping-experiences-using-spree-open-source-ecommerce-api-and-next-js.md) 
- [Next.js eCommerce](https://spreecommerce.org/category/next-js-ecommerce.md)January 20, 2026
    
    [How to Migrate Your Spree Backend to Spree 5 While Keeping Your Decoupled Frontend](https://spreecommerce.org/how-to-migrate-your-spree-commerce-backend-to-spree-5-while-keeping-your-decoupled-frontend.md)
    
    [Read more](https://spreecommerce.org/how-to-migrate-your-spree-commerce-backend-to-spree-5-while-keeping-your-decoupled-frontend.md) 
- [Next.js eCommerce](https://spreecommerce.org/category/next-js-ecommerce.md)January 16, 2026
    
    [From Tenant to Owner: Stop Building Your eCommerce on Rented Land](https://spreecommerce.org/from-tenant-to-owner-stop-building-your-ecommerce-on-rented-land.md)
    
    [Read more](https://spreecommerce.org/from-tenant-to-owner-stop-building-your-ecommerce-on-rented-land.md) 
- [Headless Commerce](https://spreecommerce.org/category/headless-commerce.md)January 13, 2026
    
    [Why the Fastest-Growing eCommerce Brands Are Choosing Next.js Storefronts on Spree](https://spreecommerce.org/why-the-fastest-growing-ecommerce-brands-are-choosing-next-js-storefronts-on-spree.md)
    
    [Read more](https://spreecommerce.org/why-the-fastest-growing-ecommerce-brands-are-choosing-next-js-storefronts-on-spree.md) 
- [Next.js eCommerce](https://spreecommerce.org/category/next-js-ecommerce.md)January 8, 2026
    
    [Next.js Home & Electronics eCommerce: 11 Storefronts From Sonos to Porsche](https://spreecommerce.org/nextjs-home-electronics-automotive-ecommerce-storefronts.md)
    
    [Read more](https://spreecommerce.org/nextjs-home-electronics-automotive-ecommerce-storefronts.md) 
- [Headless Commerce](https://spreecommerce.org/category/headless-commerce.md)December 1, 2025
    
    [How to Lift and Shift Your Next.js Storefront to a Spree 5 Backend](https://spreecommerce.org/how-to-lift-and-shift-your-next-js-storefront-to-a-spree-5-backend.md)
    
    [Read more](https://spreecommerce.org/how-to-lift-and-shift-your-next-js-storefront-to-a-spree-5-backend.md) 
- [Headless Commerce](https://spreecommerce.org/category/headless-commerce.md)June 27, 2025
    
    [15 Amazing eCommerce Websites Built with Next.js](https://spreecommerce.org/15-amazing-ecommerce-websites-built-with-next-js.md)
    
    [Read more](https://spreecommerce.org/15-amazing-ecommerce-websites-built-with-next-js.md) 
- [Headless Commerce](https://spreecommerce.org/category/headless-commerce.md)May 27, 2025
    
    [Why a Next.js Frontend + Spree Commerce Backend Unlocks Developer Productivity, Security, and Scalable Growth](https://spreecommerce.org/why-a-next-js-frontend-spree-commerce-backend-unlocks-developer-productivity-security-and-scalable-growth.md)
    
    [Read more](https://spreecommerce.org/why-a-next-js-frontend-spree-commerce-backend-unlocks-developer-productivity-security-and-scalable-growth.md) 
- [Headless Commerce](https://spreecommerce.org/category/headless-commerce.md)April 27, 2025
    
    [Why Pairing Spree Commerce with Next.js Commerce Delivers a Future-Proof eCommerce Platform](https://spreecommerce.org/why-pairing-spree-commerce-with-next-js-commerce-delivers-a-future-proof-ecommerce-platform.md)
    
    [Read more](https://spreecommerce.org/why-pairing-spree-commerce-with-next-js-commerce-delivers-a-future-proof-ecommerce-platform.md) 
- [Headless Commerce](https://spreecommerce.org/category/headless-commerce.md)May 22, 2024
    
    [Next.js Commerce: The Go-To Framework for Building Modern Storefronts](https://spreecommerce.org/next-js-commerce-the-go-to-framework-for-building-modern-storefronts.md)
    
    [Read more](https://spreecommerce.org/next-js-commerce-the-go-to-framework-for-building-modern-storefronts.md) 
- [Headless Commerce](https://spreecommerce.org/category/headless-commerce.md)February 22, 2024
    
    [Build a Next.js Ecommerce Storefront with Spree Commerce](https://spreecommerce.org/build-a-next-js-ecommerce-storefront-with-spree-commerce.md)
    
    [Read more](https://spreecommerce.org/build-a-next-js-ecommerce-storefront-with-spree-commerce.md) 

## Frequently Asked Questions

**Which open source ecommerce platforms support Next.js ecommerce?**

Spree Commerce ships a production-ready Next.js storefront with TypeScript, pre-built cart, checkout, account pages, and multi-language support. The starter connects to the REST API through a typed SDK, so frontend teams can fork the repo and start customizing immediately. Most headless platforms require building the storefront from scratch or buying third-party templates.

**How do you evaluate an open source ecommerce platform for a custom build?**

Start with API coverage, because every frontend feature depends on it. Check whether the platform provides REST endpoints, typed client SDKs, and OpenAPI specs for code generation. Then assess the developer onboarding path: a working storefront starter, a CLI that scaffolds projects, and documentation covering real deployment scenarios save weeks compared to platforms that ship only a raw API. Spree Commerce covers all five: REST API v3, a TypeScript SDK, OpenAPI 3.0 specs, a forkable Next.js storefront starter, and a CLI that scaffolds a full stack in one command.

**What makes a headless ecommerce platform developer-friendly?**

A developer-friendly headless platform ships more than an API endpoint. Look for a CLI for project scaffolding, a typed SDK for your language, a reference storefront you can fork, and OpenAPI specs that generate clients in any language. Spree Commerce ships all four (a CLI, a TypeScript SDK, a forkable Next.js storefront starter, and OpenAPI 3.0 specs), so teams build product features on day one instead of writing API boilerplate.

**What is the difference between REST and GraphQL for ecommerce APIs?**

REST APIs return flat JSON responses with predictable endpoints, making them compatible with AI agents, mobile SDKs, and server-to-server integrations without a query language. GraphQL requires a schema and typed queries, adding complexity for teams that need straightforward data access. Spree Commerce uses REST with OpenAPI 3.0, enabling typed client generation in any language without GraphQL tooling.

**How do AI shopping agents connect to ecommerce platforms?**

AI agents need REST APIs with discoverable endpoints, standardized authentication, and machine-readable product catalogs. Protocols like MCP (Model Context Protocol) and OpenAPI 3.0 give agents context to browse products, manage carts, and complete checkouts without custom integration code. Spree Commerce ships an MCP server, AGENTS.md, and a complete OpenAPI spec designed for agent-driven commerce.

**Is open source ecommerce software production-ready for enterprise?**

Enterprise-grade open source ecommerce platforms handle multi-currency pricing, cross-border tax compliance, and high-traffic storefronts in production today. Open-source licensing gives teams full code ownership with no platform fees or revenue sharing. Spree Commerce runs production storefronts for brands processing thousands of orders daily across multiple countries.

**How do you set up a headless ecommerce platform from a single command?**

A complete headless stack needs a backend API, a frontend storefront, and deployment configuration in one repository. Spree Commerce provides a single CLI command that scaffolds the full stack (REST API backend, Next.js storefront, Docker configuration) into one working repository. From there, teams deploy to any cloud provider or on-premise infrastructure, with the customer-facing layer running on TypeScript end to end.
