Developers

Build commerce that bends to you

REST + workflow APIs, event-driven webhooks, per-tenant extensions, and a production-ready storefront kit. One commerce core, many shapes.

Get started in minutes

Scaffold a Mercemur app, wire up the SDK, ship the first extension.

The CLI handles the boilerplate, modules, database schema, admin bundle, workflow engine. Everything runs locally, then you deploy wherever your team already ships.

Create a free account Jump into API reference →

terminal

# install the CLI
npx create-mercemur-app my-store

# or add Mercemur to an existing Next.js app
npm install @mercemur/js-sdk @mercemur/ui

# scaffold an extension
npx mercemur extension create my-extension

Developer surfaces

Everything you need to build on top of a real commerce core.

REST + workflow APIs

Typed Admin and Store APIs, tenant-scoped by default. Compose business logic with the workflow SDK, steps, compensations, idempotency built in.

Admin API for store operators and back-office tools
Store API for storefronts, mobile apps, and third-party channels
Workflow SDK: `createStep`, `createWorkflow`, `StepResponse`, `transform`
Tenant isolation enforced at the database layer via row-level security

Read API reference →

Event-driven architecture

Subscribe to every domain event, orders, payments, customers, catalog. HMAC-signed delivery, replay support, tenant-scoped topics.

Dozens of built-in events: `order.placed`, `payment.captured`, `customer.created`, `product.updated`
Custom events emitted from your workflows with `emitEvents` decorators
Subscriber pattern with per-handler retry + dead-letter semantics
Webhook outbound dispatch with HMAC signature verification

Explore webhooks →

Extensions & plugins

Ship modules that extend the admin UI, add new data models, or integrate third-party services. Install per-tenant; upgrade in place.

Admin widget injection zones, add UI to any admin screen
Custom modules with DML (Data Model Language) for typed schemas
Link modules connect your data to core entities without forks
Published to the Mercemur registry or installed from source

Build an extension →

Storefront Kit

A Next.js storefront template, MIT-licensed and production-tested. Use it as-is, fork it, or pull the components into your own stack.

Next.js 15 App Router with React Server Components
Ships with checkout, cart, account, search, and tenant-aware routing
Adopts the default design system, or swap for your own
Multi-language and multi-currency out of the box

Clone the Storefront Kit →

app/account/orders/page.tsx

// Server component: list the signed-in customer's orders
import { sdk } from "@/lib/mercemur-sdk"

export default async function Orders() {
  const { orders } = await sdk.store.order.list({
    fields: "id,display_id,total,created_at,items.*",
    limit: 10,
  })

  return orders.map((order) => <OrderRow key={order.id} order={order} />)
}

One SDK, end to end

A typed SDK for every surface, storefront, admin, and server-to-server.

@mercemur/js-sdk ships TypeScript types generated from the same OpenAPI specs the backend enforces, so request shapes, response fields, and error codes all match what the server actually does. Autocomplete everything, fail at compile time, not in prod.

Works in Node, Edge runtimes, and the browser
Per-tenant publishable keys for safe client-side use
Built-in retry with exponential backoff
Streams supported for bulk imports and long-running jobs

Resources

Documentation, examples, and a community to help you ship.

API reference →

Every endpoint, every field, every status code. Generated from the same OpenAPI specs the backend enforces.

Extensions guide →

Build admin widgets, custom modules, and link modules. Install them on any tenant with one command.

Storefront Kit →

Fork the production-tested Next.js template or adopt just the components you need. MIT-licensed.

# install the CLI npx create-mercemur-app my-store # or add Mercemur to an existing Next.js app npm install @mercemur/js-sdk @mercemur/ui # scaffold an extension npx mercemur extension create my-extension

// Server component: list the signed-in customer's orders import { sdk } from "@/lib/mercemur-sdk" export default async function Orders() { const { orders } = await sdk.store.order.list({ fields: "id,display_id,total,created_at,items.*", limit: 10, }) return orders.map((order) => <OrderRow key={order.id} order={order} />) }

A typed SDK for every surface, storefront, admin, and server-to-server.

Works in Node, Edge runtimes, and the browser

Per-tenant publishable keys for safe client-side use

Built-in retry with exponential backoff

Streams supported for bulk imports and long-running jobs