@dutchiesdk/ecommerce-sdk-cli

CLI and developer test bench for building and previewing Dutchie Ecommerce Pro themes — dev server, production builds, a theme generator, test fixtures, and an MCP documentation proxy.

Quick Start

pnpm add -D @dutchiesdk/ecommerce-sdk-cli

# Scaffold a new theme
npx @dutchiesdk/ecommerce-sdk-cli generate

# Start the dev server (https://localhost:4000, hot reload)
npx @dutchiesdk/ecommerce-sdk-cli dev

Commands

| Command | Description | | ---------- | ----------- | | dev | Start the test bench dev server with hot reload (HTTPS) | | build | Production build — outputs Module Federation bundles to ./dist/ | | generate | Scaffold a new theme with interactive preset and component selection | | skill | Copy the AI theme-styling skill doc into your project | | mcp | Search/fetch SDK docs, or run as an stdio proxy for MCP clients |

Run npx @dutchiesdk/ecommerce-sdk-cli <command> --help for flags, or see the full CLI reference linked below.

Repository fixtures

When developing this monorepo, use the fixture that matches the behavior under change:

• src/test-bench/themes/test-theme is deliberately small and coupled to CLI internals; use it for focused test-bench and checker unit coverage.
• integration-tests/fixtures/minimal-theme is dependency-free and only proves that the real dev server boots.
• integration-tests/fixtures/kitchen-sink-theme is a standalone consumer workspace used for broad reference-theme development and packed-package smoke validation. Start it from the repository root with pnpm dev:kitchen-sink to build/watch the SDK while the CLI uses the fixture directory as its working directory.

The packed smoke runs from a temporary directory and installs exclusively from https://registry.npmjs.org; it is the package-fidelity check, while the local workspace commands are the fast development path.

AI-Assisted Development

mcp proxies to the hosted docs so AI assistants can search SDK documentation in-editor:

{
  "mcpServers": {
    "dutchie-sdk-docs": {
      "command": "npx",
      "args": ["@dutchiesdk/ecommerce-sdk-cli", "mcp"]
    }
  }
}

Full Documentation

CLI flags/env vars, custom Rsbuild plugins, the theme generator, test bench UI, test fixtures, theme project setup, MCP subcommands, and build output all live at:

👉 docs.dutchie.com/dutchie-core-docs/dutchie-ecommerce-pro-sdk/getting-started/cli

Also see @dutchiesdk/ecommerce-extensions-sdk, the companion SDK this CLI builds and previews themes for.

Changelog

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

Peer Dependencies

• react ^18.0
• react-dom ^18.0
• @dutchiesdk/ecommerce-extensions-sdk >=0.21.0

License

MIT — Made with 💚 by Dutchie