@dutchiesdk/ecommerce-extensions-sdk

React SDK for building custom storefront extensions on the Dutchie Ecommerce Pro platform. It provides the useDataBridge() hook and supporting types/components that give your extension components typed access to dispensary data, cart state, user info, navigation actions, and async data loaders.

Alpha Release — This SDK is currently in alpha and subject to breaking changes.

Requirements

• Node.js >= 18.0.0
• React ^17.0.0 or ^18.0.0 / react-dom ^17.0.0 or ^18.0.0
• react-shadow ^20.5.0
• A Dutchie-provided development environment — the SDK alone isn't sufficient to build/deploy extensions. Contact [email protected] to request agency partner access.

Installation

npm install @dutchiesdk/ecommerce-extensions-sdk
# or
pnpm add @dutchiesdk/ecommerce-extensions-sdk

Quick Start

import React from "react";
import {
  useDataBridge,
  RemoteBoundaryComponent,
  DataBridgeVersion,
} from "@dutchiesdk/ecommerce-extensions-sdk";

const MyExtension: RemoteBoundaryComponent = () => {
  const { dataLoaders, actions, location, user, cart } = useDataBridge();

  return (
    <div>
      <h1>Welcome to {location?.name}</h1>
      <p>Cart items: {cart?.items.length || 0}</p>
    </div>
  );
};

MyExtension.DataBridgeVersion = DataBridgeVersion;

export default MyExtension;

Full Documentation

The complete guide — architecture, the Data Bridge, full API reference (hooks, components, context, types), data interface (actions, data loaders, data types), extension development guides, custom product cards, meta/SEO, event handlers, best practices, and examples — lives at:

👉 docs.dutchie.com/dutchie-core-docs/dutchie-ecommerce-pro-sdk

Also see the @dutchiesdk/ecommerce-sdk-cli package for the dev server, theme generator, and an MCP server that gives AI coding assistants direct search access to these docs.

Changelog

Release notes are published automatically to the Changelog page in the docs.

Support

• 📧 Contact your Dutchie agency partner representative, or [email protected]
• 📚 docs.dutchie.com

License

MIT — Made with 💚 by Dutchie