Overriding the default manifest
Author:
Fluent Commerce
Changed on:
14 Jan 2025
Key Points
- The UX Framework in the Fluent platform automatically checks for configured manifests in Account settings. If none exist, the Fluent web app defaults to loading using baseline manifests within the platform, ensuring a seamless and standardized user experience.
- To customize the main web app manifest or specific fragments, users should follow the naming convention, with the setting name for the main web app manifest file.
- It is recommended to override the main manifest only when adding or removing fragments; otherwise, users can efficiently modify specific fragments by overriding them individually.
Steps
General Information
By default, the UX Framework will check if any manifests are configured in the settings. The Fluent web app will be loaded using the baseline manifests within the platform if no settings exist.
The setting name for the main web app file should match the following convention:
`fc.mystique.manifest.<web-app-name>`
Fragment names are not enforced; however, they typically use the following convention:
`fc.mystique.manifest.<web-app-name>.fragment.<fragment-name>`
Should you wish to customize any part of the default Fluent web app, you can override the relevant by copying the base fragment into an setting.
To access the baseline manifests, see the tables below:
Fluent Order Management
Manifest Category | Available Template Links |
OMS | |
Dashboards | |
Management | Order Management Fragment |
Availability | |
Products | |
Unified View of | |
Stores | |
Insights | |
Admin |
Fluent Store
Manifest Category | Available Template Links |
Store | |
Waves | |
Pack | |
Orders awaiting Pick | |
Waves In Progress | |
Waves Completed | |
Customer Collections | |
Arrivals | |
Carrier Collections | |
Uncollected | |
Fluent Big Inventory
Manifest Category | Available Template Links |
Sources | |
Feeds | |
Products | |
Unified View of | |
Stores | |
Insights | |
Admin |
For details on configuring the components and the document, see the Config Guide and the Component Library.
Editing Manifest documents
Using a text editor that provides JSON syntax highlighting and validation is recommended to modify the JSON values before saving them in an setting.
Some suggested editors / IDEs include:
- Sublime Text
- Visual Studio Code
- IntelliJ
Saving the manifests to your account
documents should be stored as a JSON Setting in the context. Settings can be created and updated in either of the following ways:
- Manually via the Fluent Big Inventory app (Admin section)
- via the GraphQL Settings API
An example setting:
Field | Sample Value |
Name |
|
Type | JSON |
JSON Value |
|
Context | |
Context ID | 0 |
When loading the web app in the browser, the UX Framework identifies if there are any referenced settings on the . It overrides the baseline manifests to load your tailored configuration.
Adding new fragments to your web app
You can also add entirely new fragments to your web app. To do this, you must override the main web app and add a new reference route to the setting.
Read more about configuring Reference Routes here.
Configuring Workflows
To get to market quickly, you can use the Fluent platform's pre-built workflows or support your business processes by configuring workflows and custom rules with the Rules SDK.
The Workflow Engine (aka ) is the engine that drives the Fluent platform. The Engine enables business and automation, underpinning each Fluent app's specific feature sets and functionality. The Engine is also built to be highly scalable and provide high-performance execution across any domain. If you would like more details, you can see How it Works.