Marco Heuer

Marco Heuer

Expert Services @ Fluent Commerce

I authored

36

articles. I write about:

CLI

30

Implementation

27

Modules

8

Other resources

8

Developer tooling

7

Recommended practices

5

Workflow

5

Building Modules

4

Platform flexibility

3

SDKs

2

Learning resources

2

MCP Server

Toolpacks

Layout components

UI Component SDK

Event

Object attributes

Versioning

Connect SDK

Environments

Status

UX framework

Variables

Building blocks

Ruleset

GraphQL

Analytics

Product catalog

Order entity

Setting

Carrier

Availability management

Order Workflows

Optimize Fluent Commerce

Good-fit projects

Core Reference Module

Configuration manifest

Docs I have written

About Reference And Extension Modules

Edited 373 days ago

Modules are the package structure used by Fluent Commerce to ship preconfigured features and functions. They are designed to be self-describing, isolated, but inter-dependent assets that can work together with other modules, or be extended by custom modules, all while remaining upgradeable.Here we'll look at the different designations of Modules and describe the Module's Package Structure and Project Structure.

Agent and Skills Guide

Edited 190 days ago

This purpose of this guide is to explain the runtime model for the `@fluentcommerce/ai-skills` package by detailing its 6 agents and over 60 registered skills. This will also act as a practical reference manual to help developers understand exactly which agent handles what, which specific skills to invoke, and where those skills fit into the software development lifecycle (SDLC).

Blueprint Config Command

Edited 49 days ago

Master the `blueprint config` command to automatically generate JSON configuration files for every module in a blueprint. This article teaches implementing partners to prepare retailer-specific settings across multiple environments (dev, staging, prod) before installation.For the business, this ensures consistent environment setups and reduces deployment errors by pre-populating essential placeholders. Note: Generating configs requires retailer-level authentication. Existing files are skipped by default to protect custom edits unless you use the `--force` flag.

Blueprint Create Command

Edited 49 days ago

Learn how to use the `blueprint create` command to generate JSON manifest templates for Fluent Commerce. This article empowers implementing partners to build consistent, repeatable deployment "recipes" that slash environment setup time. For the business, this translates to faster time-to-market and reduced manual configuration errors.Note: The generated file contains placeholder versions (1.0.0) for all modules; you must manually update these to your specific requirements and validate the file before installation to ensure a successful deployment.

Blueprint Describe Command

Edited 49 days ago

Learn to use the `blueprint describe` command to preview the contents of a JSON manifest file before deployment. This article enables implementing partners to inspect module versions, source locations, and conflict rules locally without needing authentication.For the business, this provides a critical safety check, ensuring that intended configurations (such as specific order management workflows) are verified before any changes reach the account. Note: This is a read-only operation; it identifies potential issues but does not replace the `blueprint validate` command for structural health checks.

Blueprint Download Command

Edited 161 days ago

Learn how to use the `blueprint download` command to retrieve all module archives defined in a manifest without installing them. This guide enables implementing partners to archive modules for offline use, inspect contents, or build local repositories for air-gapped environments.For the business, this ensures disaster recovery readiness and simplifies distribution by creating a portable snapshot of a specific solution version. Note: This is a read-only operation and does not require Fluent Commerce authentication, though S3 sources still require local AWS credentials.

Blueprint Install Command

Edited 49 days ago

The `blueprint install` command is the engine of the Fluent Commerce Accelerator, enabling sequential installation of module collections. Partner developers gain reliable, repeatable deployments, while the business achieves operational stability and faster disaster recovery.Its built-in logic ensures safe production updates by automatically handling upgrades while blocking risky downgrades without explicit confirmation. This prevents accidental data or logic loss, resolving the pain point of manual configuration errors. Note: Installations require retailer-level authentication.

Blueprint List Command

Edited 49 days ago

Learn to use the `blueprint list` command to view and track all blueprints installed in a Fluent Commerce account. This article enables implementing partners to perform quick environment inventories and monitor version history across dev, staging, and production.For the business, this provides a clear audit trail and ensures consistency across the platform, resolving the pain point of "version drift." Note: This command requires active account-level authentication; if no blueprints are found, the CLI will return an "info" status rather than an error.

Troubleshooting the Fluent CLI (v2)

Edited 161 days ago

[Warning: empty required content area]

Blueprint Validate Command

Edited 49 days ago

Master the `blueprint validate` command to perform multi-layered health checks on manifests before deployment. Implementing partners learn to verify structural integrity, business rules, and path accessibility, ensuring error-free "recipes."This provides a business safety net, preventing broken installs and reducing downtime by catching invalid versions or conflicting filters early. Note: Validation is mandatory; the CLI blocks installations if rules (such as requiring exact semantic versions) are violated.

Bootstrap an account using the Fluent CLI

Edited 85 days ago

CLI Active Profile

Edited 161 days ago

Learn the technical mechanics of the Active Profile feature and how it streamlines CLI workflows. This article details the shift from rigid "Commander-enforced" validation to a flexible "Defaults-first" resolution, allowing implementing partners to work faster without sacrificing accuracy.For the business, this context-aware CLI reduces the learning curve and prevents manual entry errors. Note: While flags are no longer required at the command level (`required: false`), they remain mandatory for execution; the CLI will exit if no context is found.

CLI Blueprint Troubleshooting Guide

Edited 161 days ago

Fluent CLI v1.2.0

Edited 371 days ago

Fluent CLI - Template Token Functions

Guide to using `lower()`, `upper()`, and `env()` functions inside Fluent CLI template tokens.

Fluent CLI Command Cheat Sheet

Edited 49 days ago

Get a visual overview on all available commands and sub-commands for the CLI.

Fluent CLI Reference (v2.x.x)

This guide covers Fluent CLI v2.x.x, the primary tool for managing Fluent Commerce accounts and assets. Implementing partners use it to automate environment setups and integrate workflows into CI/CD pipelines. For the business, the CLI ensures faster deployment cycles and high consistency, eliminating manual configuration overhead to scale retail operations with speed.Note: Requires Node.js >=20.0.0 <25.0.0. Profiles are stored locally in `~/.fluentcommerce/`; ensure sensitive credentials are protected according to your organization's security policies.

Fluent CLI v1.0.1

Edited 660 days ago

Fluent CLI v1.0.2

Edited 532 days ago

Fluent CLI v1.1.0

Edited 496 days ago

Fluent CLI v1.1.1

Edited 482 days ago

Fluent CLI v1.1.2

Edited 405 days ago

Fluent CLI v2.0.0

Edited 254 days ago

Fluent CLI v2.2.2 - Security Update and Bugfixes

Edited 38 days ago

Fluent CLI v2.2.3 - Module Install Hardening & Profile Portability

Edited 7 days ago

Fluent CLI Blueprints Guide

Edited 49 days ago

Learn to deploy and manage module collections using accelerator blueprints. Partners can rapidly configure environments with pre-tested "recipes," while businesses benefit from faster time-to-market and reduced risk through automated conflict prevention and smart versioning.Key Values:

Efficiency: Features "Smart Resume" and upgrade detection to skip identical modules.
Flexibility: Customise via selective installation (`--include`/`--exclude`).
Note: Semantic versioning is strictly enforced; downgrades require the `--force` flag.

Module Recipe - How to update a workflow

Edited 552 days ago

Module Dependencies

Edited 405 days ago

Learn how module dependencies work, how they are described and when they are enforced.

Module Recipe - How to create an Extension Module

Edited 562 days ago

Module Recipe - How to create a new data module

Edited 604 days ago

Module Recipe - How to integrate into a CI/CD Pipeline

Edited 604 days ago

Set up a new Account with Reference Modules and B2C Sample Data

Edited 132 days ago

What is a Blueprint?

Edited 49 days ago

This guide covers the blueprint lifecycle, from design to management, teaching you to deploy pre-configured module collections using the Fluent CLI. Implementing partners gain a consistent, repeatable setup across environments, while businesses benefit from faster deployments and reduced downtime via automated conflict prevention.Key features include Smart Versioning for automatic upgrades and Snapshot Mode for development testing. Note: Production requires exact versions; semver ranges are prohibited to ensure stability.

Workflow Fragments FAQ

Edited 482 days ago

Frequently asked questions around composing a workflow from workflow fragments.

On Workflows and Workflow Fragments

Edited 405 days ago

Workflows are the backbone of the Fluent platform as they describe the lifecycle of an entity. Defining subsections or sub-processes within a workflow allows to manage and evolve them independently. Thus fostering loosely coupled and self-contained fragments with no duplication of shared or unchanged behavior of a baseline workflow.On this page we will look at the different ways of structuring workflows into fragments and then how to optimally merge them into a final workflow that is used to orchestrate entities. Finally how to package both workflows and fragments into a module.

Working with Workflows and Workflow Fragments

Edited 405 days ago

In this document we will describe how to work with workflows and workflow fragments using the Fluent CLI. Then delve into how the tool is tracking the installed workflows, fragments in the workflow log.

Disclaimer: All information and resources found on community.fluentcommerce.com are based on the opinions of the author (unless otherwise noted). All information is intended to inspire and motivate well thought through technical decisions inline with Fluent Commerce recommended practices and principles.

Copyright © 2026 Fluent Commerce