@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