Fluent Commerce Logo
Docs
Sign In

Component SDK - Overview

Essential knowledge

Author:

Fluent Commerce staff

Changed on:

25 Oct 2023

Overview

General Principles and the Features of the SDK

Key points

  • General Principles
  • Features of the SDK
  • Developer setup

General Principles

The Component SDK allows clients and partners to develop new components to extend the functionality of the Fluent web apps.

Areas of extension include:

new cards to display information from Fluent APIs or external sources

new form field types that work with rules to extend user action capability

entirely new customised pages

No alt providedNo alt providedNo alt provided

Custom components are generic React components, but via provided hooks can also take advantage of core features of the UX framework, including:

  • configurable via the manifest (which means no-code updates to apps)
  • fetching and displaying data from the Fluent APIs
  • internationalization of any text labels based on the user profile
  • auto-adapt to workflows (generating new user action forms when the workflow changes)
  • showing and hiding content based on the logged-in user's roles and permissions

Features of the SDK

Hooks

Custom components can easily interact with OMX functionality via the provided hooks.

Utility Components

Some utility components are provided to make building custom components easier and more consistent.

Registries

Before a custom component can be used in an OMX web app, it must be registered with one of the three registries:

  • Component Registry - for standard in-page components
  • Field Registry - for interactive form field components
  • Template Registry - for adding new template helpers

Details on each can be found on the registries page.

Developer setup

Information on getting started, setting up your project, and unit testing can be found here.

Fluent Commerce staff

Fluent Commerce staff

Copyright © 2024 Fluent Retail Pty Ltd (trading as Fluent Commerce). All rights reserved. No materials on this docs.fluentcommerce.com site may be used in any way and/or for any purpose without prior written authorisation from Fluent Commerce. Current customers and partners shall use these materials strictly in accordance with the terms and conditions of their written agreements with Fluent Commerce or its affiliates.

Fluent Logo