Open-source Ecommerce

April 08, 2026

Announcing Spree Commerce 5.4: A Complete Open Source eCommerce Stack

Headless Commercenext.jsopen source eCommerceREST APISpree Commerce 5.4

Spree Commerce 5.4 ships a complete open source eCommerce stack: a production-grade REST API with a TypeScript SDK, a Next.js storefront ready to deploy, and built-in cross-border eCommerce, multi-vendor marketplace, and B2B commerce. The entire customer-facing layer is TypeScript.

Key Takeaways

Last verified: April 2026

The developer story: A production-grade REST API with a TypeScript SDK and a Next.js eCommerce storefront ship as a single, deployable stack. TypeScript teams fork the starter and ship. Mobile teams generate Swift or Kotlin clients from the OpenAPI spec. SaaS platforms call the REST API from whatever backend they already run.

The business story: Launch cross-border eCommerce, multi-vendor marketplaces, and B2B commerce with a smaller team, shorter time to market, and a fraction of the upfront investment that custom builds demanded a few years ago.

Why it matters: What once required well-funded teams and months of custom engineering is now a one-command install and some configuration. Spree Commerce 5.4 is not an incremental update. It is a new headless foundation.

Quick Links:

• See Spree Commerce 5.4 release notes on GitHub
• Install Spree Commerce 5.4 with a single command
• See the Next.js eCommerce storefront repo on GitHub
• Install the Next.js eCommerce storefront
• See a demo of Spree Commerce and the Next.js storefront

Spree Commerce 5.4 Changes What You Can Build & How Fast You Ship It

Spree Commerce 5.4 ships a complete open source eCommerce stack: a typed TypeScript SDK over a production-grade REST API, a Next.js eCommerce storefront ready to fork and deploy, and everything a team needs to launch cross-border eCommerce, multi-vendor marketplaces, or B2B wholesale portals. These are not separate pieces assembled from different releases. They were designed together, as a single experience, from API contract to checkout flow.

Postman’s 2024 State of the API report found that 86% of developers consider REST APIs easier to integrate than GraphQL alternatives, citing simpler tooling and broader language support. Spree Commerce 5.4 leans into that reality. The headless eCommerce platform is accessible to any team that can make an HTTP call or use the TypeScript SDK. Run one command and you have a working store.

That shift matters at three levels, and each one speaks to both the technical team building the project and the business team funding it.

Developer Experience: From Zero to Running in Minutes

According to the 2025 Stack Overflow Developer Survey, 82% of developers say they evaluate new tools based on how quickly they can get a working prototype running. Three additions in Spree Commerce 5.4 lower that barrier to near zero.

One-command scaffolding. A single CLI command sets up a configured project with the storefront, backend, and optional Docker deployment. The wizard asks what you need and generates the right setup. Optionally, start with sample data that includes products, multiple markets, and multi-currency pricing so you can see a working multi-market store from the first run.

Agents-native development. When you scaffold a new project, Spree Commerce generates AI agent documentation (AGENTS.md) and bundles complete offline documentation in markdown format. Open the project in your AI coding assistant and it understands the API-first architecture immediately. Your AI pair programmer knows the codebase before you write a single line.

Deploy anywhere. Multi-architecture container images (ARM and x86) published via GitHub Container Registry mean your development environment matches your production servers without configuration. Any cloud, any Kubernetes cluster, any local machine with Docker.

What that means for the business: your team evaluates the platform in an afternoon, not a quarter. The time between “should we look at this?” and “here is a working prototype” collapses to hours.

Who Builds on Spree Commerce 5.4

If you are new to Spree Commerce, here is who is already building with it and what they are shipping.

Next.js storefront builders. React and TypeScript teams (in-house engineers and agency partners alike) forking the Next.js eCommerce storefront starter, customizing with AI coding tools, and shipping storefronts for D2C and B2B brands alike, marketplace operators, and cross-border commerce. The TypeScript SDK handles the connection between your storefront and the Spree Commerce backend, with autocomplete and type safety built in.

In production: Maisonette runs a multi-vendor childrenswear marketplace on Spree Commerce with a Next.js frontend, serving 65,000+ products across hundreds of brands.

Mobile app developers. iOS and Android teams consuming the REST API for native commerce experiences alongside or instead of a web storefront. The OpenAPI 3.0 specs generate native Swift or Kotlin clients automatically, so your mobile team works with typed, documented endpoints from day one. One headless commerce backend for your website and your app.

In production: “We integrated Spree’s REST API into our mobile app to bring a full marketplace shopping experience to our users connecting multiple vendors, including Shopify stores, into one seamless checkout. The API documentation was clear, the endpoints did what we needed out of the box, and we had our first vendor live in days, not months.” — Antoine Lavail, CTO @ VERO

SaaS platforms embedding shopping experiences. Teams whose core product is not eCommerce but whose users would benefit from the ability to buy or sell complementary products, creating an additional revenue stream and raising ARPU for the platform owner. Your existing buyer or seller network is the key advantage: they are already on your platform, so the commerce layer plugs into an active user base from day one.

In production: Intellum, an enterprise learning platform, uses Spree Commerce to sell courses, certifications, and event tickets directly within their LMS, turning education into a revenue channel without building commerce from scratch.

The REST API means any backend language your team already uses can integrate Spree Commerce through standard HTTP calls.

What ties all three tracks together is the REST API and the approach behind it: open standards, flat JSON, and OpenAPI specs that let any team integrate on their own terms. As AI-assisted development accelerates, having a fully documented, machine-readable API means your AI coding tools understand the commerce layer as well as your developers do.

The Next.js Storefront Ships Everything You Need to Go Live

The REST API paired with the TypeScript SDK and an open-source Next.js eCommerce storefront gives you something you can ship to production. The storefront is free, open source, and built with Next.js 16, React 19, Tailwind CSS 4, and TypeScript. Fork it, customize it, deploy it to Vercel with a single push.

This is not a demo. It is a production-grade application you can try right now. Here is what ships out of the box:

• Full shopping experience. Product catalog with category browsing and faceted navigation powered by MeiliSearch. Product detail pages with variant selection, color swatches with hex values, and media galleries. A one-page checkout supporting guest visitors, multi-shipment orders, coupon codes, gift cards, and store credit.

• Every payment method your customers expect. Credit cards, Apple Pay, Google Pay, Klarna, Affirm, and SEPA direct debit. Stripe ships as the default integration, but Payment Sessions are provider-agnostic: swap in Adyen, PayPal, or any other processor without changing your storefront checkout code. All PCI-compliant, all 3D Secure-ready.

• Complete customer accounts. Profile management, order history, an address book, saved payment methods, and gift card balances. Your customers manage their own data without you building any of it.

• Multi-language and multi-region. Full product and storefront translations with country and language routing through URL paths: /us/en/ for the US in English, /de/de/ for Germany in German. A built-in country switcher lets shoppers change markets. Every URL segment maps to a Spree Commerce Market with its own currency, payment methods, shipping rules, and translated content.

• Transactional emails as storefront components. Order confirmations, shipping notifications, and password resets are rendered in the storefront and delivered via webhooks. Your frontend team customizes email templates with the same components and styles as the rest of the store, without touching the backend.

• SEO and analytics built in. Meta tags, JSON-LD structured data, OpenGraph tags, dynamic breadcrumbs, and GA4 ecommerce event tracking ship natively. Add-to-cart, checkout, and purchase events fire without custom instrumentation.

Maisonette, a curated childrenswear marketplace serving hundreds of brands across the United States, already runs this architecture in production: Spree Commerce backend powering a Next.js storefront with 65,000+ products.

How Does Spree Commerce 5.4 Handle Cross-Border eCommerce?

When Forrester reports that 67% of online shoppers have purchased from a foreign retailer, cross-border eCommerce is no longer an edge case. It is the baseline expectation.

Markets in Spree Commerce 5.4 bundle geography, currency, locale, and payment rules into a single configurable entity. Create a market for Germany with EUR, local payment methods, and German-language product content. Create another for the UK with GBP and different shipping rules. Your multi-region eCommerce runs from one instance with one admin panel.

A new Translations Center gives your team an admin overview of which products are translated in which languages, with bulk CSV import and export. Translate hundreds of product descriptions externally or with AI, then re-import in one step. Multi-currency CSV imports work the same way: set up prices for multiple currencies in a single file upload.

Orders now record which market and language they were placed in, so transactional emails arrive in the right language automatically. Combined with customer-specific price lists, per-market currency settings, and customer segments, Markets enable scenarios that previously required multiple store instances: region-specific promotions, local tax compliance, market-specific product availability.

An ecommerce operation running across 20+ EU countries can manage every market from the same admin panel. No separate deployments. No duplicated product catalogs. One backend, as many markets as the business requires.

EU Omnibus Directive compliance arrives with automatic 30-day price history tracking. When a product goes on sale, Spree Commerce records and surfaces the lowest price from the prior 30 days. Every promotion in every EU market meets the Directive’s requirements without manual tracking. Checkout consent management with translatable policy pages, multiple sitemap support for catalogs exceeding 50,000 URLs, and per-storefront robots.txt configuration round out the compliance package.

What that means for the business: you launch in new countries by configuring a Market, not by deploying a new backend. Your operations team manages dozens of countries from the same admin panel they use for one.

What Makes Spree Commerce 5.4 a Headless eCommerce Platform?

The platforms most teams chose five or ten years ago were not built for what payment providers, search engines, and CMS tools can do today. Spree Commerce 5.4 takes a different approach: the commerce layer handles products, pricing, cart, checkout, and orders, while purpose-built tools handle everything else. When a better option appears for any layer, you swap it without rebuilding.

Payment Sessions make this real for payments. One API surface handles any payment provider. Stripe ships as the default for developer speed. Add Adyen for European volume. Layer in PayPal for buyer preference. 3D Secure, PCI compliance, and webhooks work the same regardless of provider. Your storefront checkout code does not change when you swap providers. That is what headless architecture means in practice: the freedom to change any layer without a platform migration.

As the European Central Bank noted in its 2024 report on payment innovation, “merchants increasingly demand the ability to integrate multiple payment service providers to reduce concentration risk and optimize transaction costs.” Payment Sessions are the answer.

MeiliSearch ships as the built-in search engine: typo-tolerant, faceted product filtering in single-digit milliseconds. The same experience that enterprise search vendors charge thousands per month to deliver, running on your own infrastructure. Need Algolia or Elasticsearch instead? Swap the search layer through a clean adapter without touching the rest of your stack.

A 2024 FIS Global report found that merchants lose an average of 2.1% of revenue to payment processing inefficiencies when locked into a single provider. Headless architecture is how you stop that leak.

What that means for the business: no vendor lock-in on any layer. Your finance team routes payments to the cheapest processor per region. Your product team upgrades search without a platform migration. Every integration is a choice you can revisit, not a commitment you are stuck with.

What the Spree Commerce 5 Line Has Delivered

Spree Commerce 5.4 caps a release series that has systematically expanded native capabilities across every layer of the commerce stack.

Admin and promotions:

• Rebuilt admin dashboard (5.0) with a modern, responsive interface
• Advanced promotions engine (5.1) with rule-based campaign logic

Customer and pricing:

• Customer segmentation and targeted pricing (5.2) for defining buyer groups and serving them different experiences
• Price Lists (5.3) for customer-specific pricing overrides tied to buyer organizations, regions, or individual accounts

Developer experience and headless commerce:

• Production-grade REST API (5.4) with flat JSON, rate limiting, and publishable keys
• TypeScript SDK (5.4) with autocomplete and Zod schema validation
• Next.js eCommerce storefront (5.4) ready to fork and deploy
• Payment Sessions (5.4) for provider-agnostic payment processing
• Markets (5.4) for per-country currency, language, and payment configuration
• Translations Center (5.4) for bulk product localization
• MeiliSearch integration (5.4) for fast, typo-tolerant product search
• EU Omnibus Directive compliance (5.4) with automatic 30-day price history

The cumulative picture is an open-source eCommerce platform that ships native support for B2B pricing, multi-currency commerce, provider-agnostic payments, and headless storefronts. Not through plugins, not through third-party extensions, but as part of the core product. Each release builds on the same codebase, the same API contracts, and the same upgrade path.

From Custom Builds to Modern Headless Commerce: The Maisonette Story

When Maisonette launched in 2018, building a custom multi-vendor marketplace at their scale required a $15 million investment in engineering, infrastructure, vendor onboarding, daily marketplace operations, and platform assembly. The frontend was a custom-built Next.js application. The marketplace layer required separate third-party vendor orchestration software with six-figure annual contracts. Wiring everything together demanded a dedicated engineering team and months of integration work before the first product page went live.

That was the cost of building marketplace commerce in 2018.

Spree Commerce 5.4 changes the economics. A marketplace business today gets a production-ready Next.js eCommerce storefront out of the box, a native marketplace module with vendor onboarding and commission management, and a REST API that makes custom integrations straightforward rather than heroic.

The architecture is modern, headless, configurable, and low-maintenance, yet delivers the same smooth Next.js shopping experience and marketplace scalability that made Maisonette successful.

Today, Maisonette serves 65,000+ products from hundreds of independent brands to customers across the United States. It validates that Spree Commerce can power high-volume marketplace operations at real scale.

The difference is that any marketplace business can now get to market in weeks, at a fraction of the upfront and recurring cost, without assembling the stack from scratch.

What Can You Build With Spree Commerce 5?

Multi-Vendor Marketplaces

The Community Edition ships a marketplace starter module so you can evaluate the multi-vendor model before upgrading. Out of the box, it includes:

• Vendor onboarding and approval with configurable approval workflows
• Vendor dashboard for self-service product management, order fulfillment, and returns
• Commission management with configurable rates per vendor, per category, or per product
• Split-shipment tracking across multiple vendors per order

The Enterprise Edition adds the automations that make marketplace operations hands-off at scale:

• Stripe Connect payouts for automated commission splitting and vendor disbursements
• Adyen for Platforms for enterprise marketplace payment processing
• Promotion commission overrides that let vendors fund their own promotions with configurable commission adjustments
• Automated vendor onboarding from existing stores with two-way product, inventory, and order synchronization so vendors keep selling while they migrate

B2B and Wholesale Commerce

Price Lists assign custom pricing by buyer organization, geography, or customer segment. Combine them for volume pricing, wholesale tiers, or region-specific rates. A wholesale eCommerce portal can run alongside your DTC storefront on the same backend, with completely separate catalogs, pricing, and checkout flows.

Nuherbs, a wholesale botanicals distributor, uses this exact setup. B2B wholesale and B2C consumer brands run under one roof, each with its own buying flows, price lists, and customer segmentation, all drawing from the same unified product catalog and inventory. The wholesale portal serves bulk buyers with negotiated pricing. The B2C storefronts target retail customers with a completely different checkout experience, all from one backend with zero duplication.

Multi-Tenant and White-Label Platforms

GoDaddy built a platform on Spree Commerce that powers over 10,000 stores with per-tenant isolation, custom domain mapping, branded admin experiences, and independent configuration, all from a single codebase.

Now you can build the same kind of platform with the Enterprise Edition’s multi-tenant module, without the custom engineering GoDaddy invested in. Less development, faster time to market, headless from day one, and low maintenance because every tenant shares one upgrade cycle. Whether it is a franchise network, a merchant SaaS, or a brand portfolio, that scale is now available out of the box.

Multi-Store Commerce

Operate multiple storefronts from one backend. Each store gets its own catalog, pricing, payment methods, and shipping configuration. Nuherbs runs exactly this way: a B2B wholesale portal and multiple B2C consumer brands, each with distinct buying flows and customer segmentation, all drawing from one shared catalog.

Combined with Markets for per-region localization, multi-store eCommerce provides the infrastructure for brands expanding into new geographies or new business models without multiplying their operational complexity.

Spree Commerce Enterprise Edition

For organizations building multi-vendor marketplaces, multi-tenant platforms, B2B wholesale portals, or complex cross-border operations, the Enterprise Edition adds the infrastructure, support, and security that mission-critical commerce requires.

Enterprise Platform

Built on battle-tested open-source foundations with the operational capabilities enterprise teams expect:

• Handles operations at scale. High-performance APIs and a caching layer optimized for catalog sizes in the tens of thousands of SKUs and order volumes in the millions.
• Runs on any infrastructure. Deploy on AWS, GCP, Azure, or your own data center. Multi-architecture container images ship with every release. No cloud vendor lock-in.
• Customizable and extensible. Override any component without forking the core. Extensions, decorators, and a clean module system let you adapt the platform to your business logic.
• Integrates with your systems. REST APIs for every resource mean your ERP, PIM, WMS, and marketing automation tools connect through standard HTTP calls.
• Role-based access control. Fine-grained admin permissions by role, store, and resource type. Operators see only what they need.

Enterprise Support Services

Your success is backed by the team that builds Spree Commerce. Expert support, proactive monitoring, and direct access to engineers who know your platform inside out.

• Dedicated Success Manager who knows your business, your architecture, and your roadmap
• SLA-Backed Response Times with contractual guarantees for critical, high, and standard issues
• Group Chat and Email Support for day-to-day questions and coordination
• Long-Term Support (LTS) releases with extended maintenance windows
• Priority Fixes and Change Requests that move to the front of the development queue
• 24/7 Monitoring and Response for production-critical environments
• Professional Services On-Demand for custom development, migrations, and architecture reviews

Enterprise Security by Default

Engineered to pass your security review. Built with security practices aligned with SOC 2 Type 2 and ISO/IEC 27001 standards so you can focus on growth, not compliance gaps.

• Encryption at rest and in transit across all data stores and API communication
• Single Sign-On (SSO) of choice with SAML and OpenID Connect support
• PCI DSS compliance through tokenized payment processing via Stripe and Adyen
• Role-based access control with per-resource, per-store permission granularity
• Audit logging that records every admin action, configuration change, and data access event
• Continuous security patches delivered as part of the regular release cycle
• Full stack ownership. You own the code, the data, and the infrastructure. No vendor holds your keys.

If your use case requires enterprise infrastructure, dedicated support, or security compliance out of the box, Get in touch about the Enterprise Edition.

Get Started With Spree Commerce 5.4

Spree Commerce 5.4 ships the commerce engine, the REST API, the TypeScript SDK, and the Next.js storefront as a single, coordinated open source stack. Every component is free, open source, and designed to work together.

Install Spree Commerce with a single command, fork the storefront, and you will have a working commerce application in minutes. For enterprise requirements, Get in touch.

Quick Links:

• See Spree Commerce 5.4 release notes on GitHub
• Install Spree Commerce 5.4 with a single command
• See the Next.js eCommerce storefront repo on GitHub
• Install the Next.js eCommerce storefront
• See a demo of Spree Commerce and the Next.js storefront

Frequently Asked Questions