Headless Commerce

February 16, 2026

Spree Commerce API v3 & the Next.js Storefront Starter for Amazing Shopping Experiences

Brands like Maisonette run Next.js ecommerce storefronts on top of the Spree API for a reason: it delivers the kind of fast, smooth shopping experience that converts browsers into buyers. With the Store API v3 and the open-source Next.js eCommerce storefront, Spree Commerce 5.4 gives product teams and agencies the fastest path from idea to that same production-grade experience using a free open-source eCommerce stack.

Key Takeaways

Who it’s for: Product teams and agencies building modern storefronts on an open-source eCommerce backend.

What it delivers: A production-grade Next.js starter kit paired with Spree’s redesigned Store API v3 for fast, SEO-friendly shopping experiences with full design freedom.

Last verified: April 2026.

Why Next.js + Spree Is the Right Architecture for Modern Storefronts

Next.js is the most popular framework for building fast, SEO-friendly web applications, and it is the same technology behind the storefronts of Nike, Walmart, Target, Lego, eBay, IKEA, H&M, Wayfair, CVS, Under Armour, Sephora, Samsung, Puma, LG, Carrefour, Marks & Spencer, and LUSH Cosmetics.

When you pair it with Spree’s open-source eCommerce backend, the result is a storefront that is genuinely better for your customers, your developers, and your business.

Faster storefronts, higher conversions. Next.js storefronts load fast on any device and any connection. Faster pages mean lower bounce rates, better conversion rates, and higher search engine rankings. This is not marginal. Studies consistently show that every second of load time impacts revenue.

Your frontend team moves independently. Designers and frontend developers can ship new features, A/B tests, and seasonal campaigns without waiting on backend changes or risking them. The backend stays stable while the storefront evolves as fast as your market demands.

One backend, unlimited frontends. Your Spree backend serves the Next.js storefront today. Tomorrow it can also power a mobile app, a wholesale portal, a marketplace, or an AI shopping assistant, all through the same Store API v3. Read more about why pairing an open-source eCommerce backend with Next.js delivers a future-proof platform.

Total design freedom. Unlike SaaS platforms where you pick from templates and themes, a Next.js storefront gives your team complete creative control. Every pixel, every interaction, every micro-animation is yours to design. This is how brands like those in our Next.js showcase create shopping experiences their competitors simply cannot replicate.

The Next.js Storefront Starter: From Zero to Storefront

The official Next.js Storefront Starter is not a proof-of-concept or a weekend hackathon demo. It is a production-grade, fully featured open-source eCommerce storefront built on Next.js, React, Tailwind CSS, and TypeScript, the cutting edge of the frontend ecosystem.

What you get out of the box

• Browsing and discovery: product pages, categories, filtering, and search that shoppers expect from any serious store
• Cart and checkout: a complete buying flow, ready to connect to your payment provider
• Customer accounts: profiles, order history, saved addresses, and payment methods so returning customers can buy faster
• Sell in multiple countries: built-in support for switching countries and currencies
• Looks great on every device: responsive, mobile-first design that works on phones, tablets, and desktops
• Built-in monitoring: know immediately when something breaks, before your customers tell you

Your team connects the starter to Spree and has a fully working store in minutes. From there, everything is customizable: the look and feel, the user flows, the checkout experience, the integrations. It is your code, your brand, your rules.

Store API v3: Built for the Way Teams Work Today

The API is the connection between your storefront and Spree’s commerce engine, and it is what your team builds on every day. API v3 was redesigned to make that experience faster, safer, and far less frustrating.

For agencies, it means shorter project timelines. For in-house teams, it means fewer blockers and more time spent on the shopping experience itself.

Fast and simple. The new API follows the same design principles used by major payment and tech platforms. Your developers spend less time fighting the API and more time building features. Performance is dramatically improved, meaning faster page loads even with large catalogs and high traffic.

Secure by default. Every storefront is isolated and protected, and sensitive data never leaks to the browser. Native integrations with Stripe and Adyen carry that same security-first approach through to checkout.

A joy to build on. Documentation stays automatically in sync with the actual API, so there is no more guessing or outdated references. The official SDK gives your developers a ready-made toolkit so they can move fast without reinventing the wheel. For a deeper look, see Developer Tools: Productivity Boost for eCommerce Engineering.

For teams with existing integrations, the transition is smooth: the previous API continues to receive security patches, so you can migrate at your own pace.

Spree Natively Supports the Complex Commerce Scenarios

One of Spree’s defining strengths as an open-source eCommerce platform is that the hard problems of commerce are solved at the platform level, not punted to third-party plugins or custom code. Out of the box, Spree handles:

Multi-store operations. Run multiple storefronts from a single backend, each with its own domain, branding, catalog, and configuration, while sharing infrastructure and a unified admin dashboard. This is ideal for businesses managing regional storefronts, sub-brands, or distinct customer segments.

Multi-currency and multi-language. Sell globally with localized pricing, translated content, and region-specific tax and shipping rules. Spree’s internationalization support is built into the data model, not layered on as an afterthought.

B2B and wholesale. Support customer-specific pricing, volume discounts, purchase orders, and approval workflows alongside your B2C storefront, or as a standalone operation.

Any product catalog, no matter how complex. Whether you sell clothing in multiple sizes and colors, configurable bundles, or products with dozens of attributes, Spree’s flexible product data model handles it without workarounds.

Promotions and pricing rules. Run percentage discounts, free shipping, buy-one-get-one, tiered pricing, and custom promotions, all set up and managed from the admin dashboard without touching code.

These are not features you configure through third-party apps. They are part of the core open-source eCommerce platform, maintained by the same team that builds everything else.

Enterprise Edition: Purpose-Built Modules for Complex Commerce

For businesses whose requirements go beyond what any open-source eCommerce community edition can cover, Spree Enterprise Edition adds purpose-built modules that would otherwise require months of custom development:

Multi-vendor marketplace. Full vendor management with self-service onboarding, vendor dashboards, automated integrations with Shopify and WooCommerce for catalog sync, and per-vendor reporting. Build your own marketplace where third-party sellers list and fulfill their own products. See the full list of marketplace capabilities.

Multi-tenant architecture. Give each tenant their own isolated store while managing everything from one place. Control how much autonomy each tenant gets, from tightly managed franchise and reseller networks to fully independent operators. This is the foundation for building your own commerce SaaS platform. Explore the full multi-tenant capabilities.

Multi-brand enterprise. Run several independent storefronts representing distinct brands, regions, or divisions on shared infrastructure. Each brand gets full autonomy while the parent organization maintains operational efficiency and consistency.

Advanced security and governance. Configurable user roles, full audit logging, and enhanced access controls give enterprises the compliance and governance tooling they need.

Each of these modules is maintained by the core Spree team, the same engineers who build the platform itself.

Enterprise Support: Your Success Is Backed by the Team That Builds Spree

Whether you are an agency delivering a client project or an in-house team running a mission-critical storefront, Spree Enterprise support gives you direct access to the engineers who know the open-source eCommerce platform inside out. That means guaranteed response times, proactive monitoring, and expert guidance, from go-live through daily operations and beyond.

Enterprise support includes a dedicated success manager, SLA-backed response times, group chat and email support, long-term support (LTS) releases, priority fixes and change requests, 24/7 monitoring, and professional services on demand.

For agencies, this means you can confidently scope and deliver Spree projects knowing that the platform team has your back, not as a distant vendor, but as a hands-on partner invested in your project’s success.

No SaaS Will Ever Match What an Empowered Team Can Build

There is a reason the most ambitious commerce brands (from Maisonette to Blue Bottle Coffee, from GoDaddy to Huckberry, from Craftsman and Kenmore to DieHard) run on open-source eCommerce foundations rather than SaaS platforms.

The reason is control. When your business needs a unique checkout flow, a custom pricing model, or a proprietary logistics integration, a SaaS platform gives you a waitlist. An open-source eCommerce stack gives you the source code.

With Spree and Next.js, every line of code is yours to read, modify, and extend. Every deployment happens on your timeline, in your infrastructure, under your control. The businesses that win in commerce are the ones that own their technology stack rather than renting it.

AI Changes the Economics of Custom Development

AI-assisted development has fundamentally changed the build-vs-buy equation. Tools like Claude, Cursor, and GitHub Copilot mean that a lean team can now build and maintain a custom storefront that would have required a large agency engagement just two years ago.

This shift disproportionately favors open-source eCommerce platforms. AI tools perform at their peak when they can read the source code, documentation, and developer toolkits, exactly what Spree Commerce 5 provides openly. Teams who previously dismissed open-source eCommerce as too complex should reconsider the math.

Backend-heavy teams can now design storefronts too. One of the most exciting developments is v0 by Vercel, an AI-powered tool that generates production-ready React and Next.js UI from simple text or image prompts.

This is a game-changer for teams that have strong backend and eCommerce expertise but lack dedicated frontend designers. A product manager can describe a product listing page, a developer can paste a screenshot of a competitor’s checkout flow, and v0 produces clean, styled Next.js components ready to drop into your Spree storefront.

Combined with Spree Commerce 5’s AI rules for Cursor and Claude, which encode Spree’s architectural conventions so AI assistants generate code that fits naturally into existing projects, even a small team of backend developers can design, prototype, and ship a polished shopping experience without hiring a frontend agency.

Already on Spree? Here Is Your Path Forward

If you already have a storefront running on Spree, you can lift and shift it to Spree Commerce 5 without rebuilding from scratch. Your existing store keeps working the entire time, and customers never notice the upgrade happening behind the scenes. See also: how to migrate your backend to Spree Commerce 5 while keeping your current storefront.

If you are ready for a fresh shopping experience, the open-source Next.js eCommerce storefront gives you a fully working store out of the box: product pages, cart, checkout, accounts, and all. Run npx create-spree-app to scaffold everything in minutes, then customize to match your brand.

Get Started with Spree Commerce 5.4

Spree Commerce 5.4 ships a production-ready Next.js storefront, a TypeScript SDK, and a one-command CLI installer. The Store API v3 described above is now paired with developer tooling that makes the entire stack accessible to AI coding assistants from day one.

What 5.4 adds for teams building on the Store API:

• TypeScript SDK (@spree/sdk) with full autocomplete replaces manual API calls with typed, safe integrations.
• One-command install via npx create-spree-app scaffolds Spree + the Next.js storefront in minutes.
• AI-assisted development with AGENTS.md and an MCP server means Claude Code, Cursor, and Copilot understand the entire Spree codebase, data model, and API conventions from the first prompt.
• Next.js eCommerce storefront ships with React-rendered transactional emails, native MeiliSearch search, dynamic breadcrumbs, multi-sitemap, robots.txt, privacy/consent, and color swatch filters.
• Multi-language and multi-region URL routing built into the storefront for cross-border eCommerce.
• Live demo at demo.spreecommerce.org shows the production storefront running against a real Spree backend.

Frequently Asked Questions