ROBEI.

Project Technology

CMS & Ecommerce

Content management systems, ecommerce platforms, digital commerce, and business operations.

CMS and ecommerce platform technology artwork

Architecture

Hybrid Headless Commerce

Hybrid Headless Commerce built on WooCommerce and Next.js

A Headless WooCommerce Storefront with a custom Next.js customer experience and a mature commerce backend.

DoneDealion uses WooCommerce as its commerce and administration engine while a custom Next.js application owns the customer-facing storefront, checkout, and account experience. WordPress supports administration, APIs, media, and the WooCommerce plugin runtime; it is not used as the customer-facing website builder.

This is a deliberate architecture decision. WooCommerce retains the mature commerce capabilities it already handles well, while Next.js provides the custom user experience and integration layer for identity, AI, automation, CRM, and accounting workflows.

Engineering Rationale

Why WooCommerce Still Makes Sense

WooCommerce already provides product and variation management, inventory, orders, shipping configuration, customer records, administration, webhooks, and refund administration. Rebuilding those mature capabilities would add cost, risk, and maintenance without creating unique customer value.

Rather than rebuilding mature commerce capabilities, the architecture reuses WooCommerce where it is strongest and focuses custom development on user experience, AI, identity, automation, CRM, and accounting integration.

Core Platforms

Commerce Foundation

Two established platforms provide administration, APIs, media, and the commerce system of record behind the custom storefront.

System Ownership

Responsibility Split

Each layer has a defined role, keeping customer experience separate from commerce administration and operational compatibility.

Next.js Storefront

  • Homepage
  • Product pages
  • Category pages
  • Search
  • Cart
  • Checkout
  • Account experience
  • Login and registration UI
  • Customer-facing navigation
  • AI and behavioral frontend integration

WooCommerce

  • Products and variations
  • Prices and SKUs
  • Inventory
  • Customers
  • Orders
  • Shipping configuration
  • Payment configuration
  • Order statuses
  • Webhooks
  • Refund administration

WordPress

  • Administration
  • REST API infrastructure
  • Product media
  • Plugin runtime
  • Internal fallback rendering

DoneDealion Child Theme

  • Operational refund integration hook
  • Limited compatibility behavior
  • Internal presentation and fallback support

The child theme is not the public storefront.

Connected Systems

Architecture Flow

Customer commerce path

  1. Customer
  2. Next.js Storefront
  3. WooCommerce REST API
  4. WooCommerce Commerce Engine
  5. WordPress Administration

Supporting commerce integrations

  1. WooCommerce
  2. Customer Ecosystem
  3. AI / Email orchestration
  4. Thumbmark CRM
  5. FinFlow Accounting

Engineering Decision

Why I Did Not Build Everything From Scratch

I use proven software where it already solves mature business requirements well. This lets me focus custom development on the areas that create unique value: customer experience, AI-assisted commerce, identity, automation, CRM connectivity, and accounting workflows.

The result is a purposeful division of responsibilities: established commerce administration behind a custom storefront and integration layer.

Confirmed Advantages

What This Architecture Enables

Independent customer-facing frontend

The storefront experience can evolve separately from backend administration.

Mature commerce administration

Products, inventory, orders, shipping, and refunds use established workflows.

Reusable API-driven backend

Commerce data can support the storefront and connected operational services.

Reduced dependence on WordPress themes

Public presentation is owned by Next.js rather than theme templates.

Easier AI and service integration

The custom application layer can connect specialized services around commerce events.

Multi-system commerce workflows

Customer, CRM, email, AI, and accounting processes can remain connected.

Balanced Assessment

Honest Tradeoffs

More moving parts

The storefront, commerce backend, and supporting services must be operated as a connected system.

REST API and webhook dependence

Reliable commerce behavior depends on stable API contracts and event delivery.

Cross-service synchronization

Customer and commerce data must remain consistent across connected services.

Separate deployments and monitoring

Frontend, backend, and integration services have distinct release and operational needs.

Operational plugin dependencies

Plugin behavior and child-theme hooks can still affect backend workflows.

Caching and revalidation complexity

Fresh commerce data requires deliberate caching and update decisions across system boundaries.

Continue Exploring