- Get Started
- Functionality
- Learning
- Extension
- Dev Tooling
- APIs
- Releases
Author:
Fluent Commerce
Changed on:
24 June 2026
`fc.mystique.manifest.<appname>`The manifest document can get pretty big, so it's possible to split a single manifest into smaller fragment settings and manage each separately.See Reference Routes below for more information on splitting routes into separate JSON documents.For example, the Fluent Commerce UIs have the following settings:`fc.mystique.manifest.oms``fc.mystique.manifest.store``ACCOUNT` context and contains a specific JSON structure.`https://<account>.<environment>.apps.fluentcommerce.com/<appname>`.Notice how the `<appname>` in the setting matches the URL path.| Name | Type | Required | Description |
| manifestVersion | `string` | Yes | The version of the Web App Manifest schema. At present, this should always be set to `2.0`. |
| name | `string` | Yes | Name of the app used in logs and when filtering user actions. |
| title | `string` | Yes | Name of the app used in visible locations (app header, browser title bar, etc). Since this is end-user visible, it should be translated via i18n. |
| homePath | `string` | Yes | The initial page to load on login, or whenever no other page is referenced in the URL. |
| icon | `string` | No | The icon associated with this web app. See Icons for details. |
| orchestrationAlias | `string` | No | Enables us to rename 'servicepoint' to 'store' without changing all the workflows. |
| context | `MystiqueManifestRole` | No | Defines the application context, access restrictions, and context-switching behavior. The configuration specifies the context level (`account`, `retailer`, or `location`), optional roles required to access the application, and whether users can switch between available contexts. |
| plugins | `MystiquePluginSetting` | `MystiquePluginURL` | No | Defines the Component SDK plugins to load while rendering this app. |
| routes | `MystiqueRoute[]` | Yes | The pages available in this app (see [Route-level Configuration][7]). |
| settings | `{defaults: ApiSetting[]}` | No | Default settings values that are used out of the box. |
| header | `MystiqueHeader` | No | Components can be added for both mobile and desktop views, appearing between the app name and context name. Accepts standard `MystiqueComponentInstance` properties.In addition to the standard array of properties, the `position` property determines the component's position and can have values of "left", "right", "center" or "centre". This is an optional property with a default value of `left`. |
| Name | Type | Required | Description |
| type | `setting` | Yes | Type of plugin. |
| setting | `string` | Yes | Name of the setting. |
| Name | Type | Required | Description |
| type | `url` | Yes | Type of plugin |
| src | `string` | Yes | URL or path from which the plugin bundle is loaded. |
| Name | Type | Required | Description |
| name | `string` | Yes | Name of default setting. |
| value | `any` | Yes | Value of default setting. |
| Name | Type | Required | Description |
| desktop | `MystiqueComponentInstance & { position: string }[]` | No | Allows a builder to configure extra header components between the icon/app name and the location selector/user menu shown on desktop screen dimensions.`position` allows the builder to specify (`left, right, centre/center`), which determines where the component is placed on the header. |
| mobile | `MystiqueComponentInstance & { position: string }[]` | No | Allows a builder to configure extra header components between the icon/app name and the location selector/user menu shown on mobile screen dimensions. `position` allows the builder to specify (`left, right, centre/center`), which determines where the component is placed on the header. |
| Name | Type | Required | Description |
| level | `account | retailer | location` | Yes | The `level` property defines the app's context. For example, this could be either at a “retailer” (Fluent OMS) or “location” (Fluent Store) level.If not provided, it will default to the value`{ "level": "retailer" }` |
| role | `string| string[]` | No | The `role` property can be optionally defined as either a single role or an array of roles. Users must have at least one of the specified roles within the configured context to access the application. Users without the required role will not see the application in navigation, application selectors, or context switchers and cannot access it directly. |
| switcher | `boolean` | No | The `switcher` property can be optionally defined, allowing users to switch contexts within the app. If this property is enabled and a user has multiple contexts at the same level, a dropdown will appear in the top-right of the app, allowing navigation between contexts. The dropdown will contain 10 contexts, and the list will be scrollable for additional contexts. |
`MystiqueRoutes`, which are either "Page", "Section", or "Reference" (see below), along with other fields depending on that type.| Name | Type | Req | Description |
| type | `page` | Yes | Defines this route as a page. |
| path | `string` | Yes | The URL for this page. This URL can optionally include parameters, which may then be used in the GraphQL query and/or page components. Parameters are denoted with a colon. For example, when visiting a page with a path of `/orders/:id`, such as `/orders/123`, the value `id = 123` would be available in the page query to retrieve the corresponding Order. |
| fullScreen | `boolean` | No | Determines if the left side navigation is shown on pages within the route. The default value is `false`. |
| nav | `MystiqueNavConfig` | No | Details for configuring the Nav bar properties are provided in the table below. |
| roles | `string[]` | No | If present, users must have at least one of the specified roles within the application context to access the page.Restricted pages are hidden from navigation and return a 404 response when accessed directly via URL.Note: At the application level, access is configured using the `context.role` property. At the page and section level, access is configured using the `roles` property. |
| component | `string` | Yes | Name of the component to be used to render this page. Typically, `fc.page`, but any registered component can be used, so long as it's designed to fill a screen. |
| data | `GQLQuery` | No | If present, the specified GraphQL query is executed before the page is rendered, and the resulting data is made available to the page and its descendants. Query variables support template expressions and can reference: • User context information ( `activeUser`, `username`, `attributes`)• Retailer context ( `activeRetailer.id`, `activeRetailer.ref`) for retailer-level applications• Location context ( `activeLocation.id`, `activeLocation.ref`, `activeLocation.primaryAddress`, `activeLocation.longitude`, `activeLocation.latitude`) for location-level applications• URL parameters (for example, `{{params.id}}` on a route such as `/orders/:id`)• Other supported template helpers Template expressions always resolve to strings. When a GraphQL variable requires a non-string value, set `parse: true` to apply `JSON.parse` before the query is executed. |
| props | `MystiquePageProps` | No | The component props should be passed to the page component. These will differ depending on the component, so refer to the individual component documentation for more details. |
| descendants | `MystiqueComponentInstance[]` | No | The components to display on the page. Refer to individual component documentation for more details. |
| Name | Type | Required | Description |
| label | `string` | Yes | The label is the user-facing text that defines the page name and should use a translatable i18n key. |
| icon | `string` | Yes | The icon is displayed in the page's nav bar. |
| badge | `BadgeProperties` | No | Badges are configured to show a number of outstanding items for a particular page.Badge properties are defined in the table below. Note: Badges are limited to 999 outstanding items. After 999 results are returned, then 999+ will be shown to the user. |
| Name | Type | Required | Description |
| queryName | `string` | Yes | Takes a named GraphQL Schema query. This is used to retrieve a count of outstanding items from the GraphQL query. |
| variables | `key/value map` | No | Takes properties that are available in the query to filter data. |
| thresholds | `ThresholdsProperties` | No | Define the badge and number colors using low and high thresholds to indicate the severity of outstanding items.Note: If the `thresholds` object is removed, the badge color is always purple. Threshold properties are defined in the table below. |
| Name | Type | Required | Description |
| thresholdLow | `number` | Yes | If results are below this threshold, then the badge will be green. |
| thresholdHigh | `number` | Yes | If the results exceed this threshold, the badge will be red. When results are between `thresholdLow` and `thresholdHigh` the badge will be orange. |
| Name | Type | Required | Description |
| type | `section` | Yes | Defines this route as a section. |
| nav | `MystiqueNavConfig` | Yes | Details for configuring the Nav bar properties are provided in the table MystiqueNavConfig. |
| roles | `string[]` | No | If present, users must have at least one of the specified roles within the application context to access the section.Restricted sections and all child pages are hidden from navigation and return a 404 response when accessed directly via URL.Note: Access to child pages does not override access restrictions defined on the parent section. If a user cannot access a section, none of its pages are accessible even if the page itself specifies a matching role. |
| pages | `MystiquePage[]` | Yes | Pages within this section, as defined in the page section above: Page Routes. |
| Name | Type | Required | Description |
| type | `reference` | Yes | Defines this route as a reference. |
| settingName | `string` | Yes | Defines the name of the Setting to load the manifest fragment |
| Name | Type | Required | Description |
| manifestVersion | `string` | Yes | Version of the Mystique Manifest schema. At present, this should always be set to `2.0`. |
| routes | `MystiqueSection[] | MystiquePage[]` | Yes | The pages available in this app (see Route-level Configuration). |
| settings | `FragmentSetting[]` | No | Defines settings that are preloaded into the application cache and can be used by the manifest during runtime. |
| Name | Type | Required | Description |
| name | `string` | Yes | Name of setting |
| value | `any` | Yes | Default value of the setting. This value is used when no value exists in the Settings service. |
| alias | `string` | No | An optional alias is used when referencing the setting value in queries or templates. This is useful when a setting value needs to be exposed as a variable within a query configuration. |
| Name | Type | Required | Description |
| component | `string` | Yes | Name of the component in the ComponentRegistry. Refer to component docs for specific examples. |
| props | `key/value map` | No | The component props to be passed into the component.These will differ depending on the component, so refer to the individual component documentation for more details. |
| dataSource | `string` | No | Select the subset of the page query that this component will use to render.This mostly just helps to shorten configuration in the props area so that each data reference doesn't have to write out the full path every time. |
| descendants | `MystiqueComponentInstance[]` | No | Some components allow nesting of other components within them, e.g., the `fc.tabs.card` component uses its descendants to represent the content displayed in each tab. |
| Setting Name (local storage key) | Type | Description |
| mystique.dev.overrides.manifest | `JSON` | A Manifest document defining an app. If set, OMX will load this regardless of the app name in the URL. Any fragment references in the manifest will be resolved from the API as normal. |
| mystique.dev.overrides.manifestSettingName | `string` | A setting name. If set, OMX will query the setting API for this key and use its value as the app manifest. Any fragment references in the manifest will be resolved from the API as normal.For example, you may have a development version of the Store app in the `example.manifest.store.dev` setting. |
1{
2 "manifestVersion": "2.0",
3 "name": "store",
4 "title": "Fluent Store",
5 "orchestrationAlias": "servicepoint",
6 "homePath": "waves",
7 "plugins": [
8 {
9 "type": "url",
10 "src": "/_plugins/store"
11 },
12 {
13 "type": "url",
14 "src": "/_plugins/returns"
15 }
16 ],
17 "context": {
18 "level": "location",
19 "role": ["STORE_ASSISTANT", "STORE"],
20 "switcher": true
21 },
22 "routes": [
23 {
24 "type": "reference",
25 "settingName": "fc.mystique.manifest.store.fragment.waves"
26 },
27 {
28 "type": "reference",
29 "settingName": "fc.mystique.manifest.store.fragment.returns"
30 }
31 ],
32 "header": {
33 "desktop": [
34 {
35 "position": "left",
36 "component": "fc.mystique.collapsible.text",
37 "props": {
38 "text": "text",
39 "charCutoff": 100
40 }
41 }
42 ],
43 "mobile": [
44 {
45 "position": "center",
46 "component": "fc.mystique.collapsible.text",
47 "props": {
48 "text": "text",
49 "charCutoff": 100
50 }
51 }
52 ]
53 }
54}
551{
2 "routes": [
3 {
4 "type": "page",
5 "path": "orders",
6 "component": "fc.page",
7 "fullScreen": true,
8 "nav": {
9 "label": "i18n:fc.om.orders.index.nav",
10 "icon": "library_books",
11 "badge": {
12 "queryName": "orders",
13 "variables": {
14 "status": [
15 "ACTIVE"
16 ]
17 },
18 "thresholds": {
19 "thresholdHigh": 5,
20 "thresholdLow": 3
21 }
22 }
23 },
24 "roles": [
25 "ORDER_ADMIN",
26 "CUSTOMER_SERVICE"
27 ],
28 "props": {
29 "title": "i18n:fc.om.orders.index.title",
30 "actions": true
31 },
32 "data": {
33 "query": "query($orders_first: Int) { orders(first: $orders_first) { edges { node { id type status items { edges { node { currency } } } createdOn } } } }",
34 "variables": {
35 "orders_first": 100
36 }
37 },
38 "descendants": [
39 {
40 "component": "fc.list",
41 "props": {
42 }
43 }
44 ]
45 }
46 ]
47}1{
2 "routes": [
3 {
4 "type": "section",
5 "nav": {
6 "label": "i18n:fc.om.nav",
7 "icon": "shopping_cart"
8 },
9 "roles": [
10 "ORDER_ADMIN",
11 "CUSTOMER_SERVICE"
12 ],
13 "pages": [
14 {
15 "type": "page",
16 "path": "orders",
17 "component": "fc.page"
18 }
19 ]
20 }
21 ]
22}1{
2 "routes": [
3 {
4 "type": "reference",
5 "settingName": "fc.mystique.manifest.store.fragment.waves"
6 },
7 {
8 "type": "reference",
9 "settingName": "fc.mystique.manifest.store.fragment.returns"
10 }
11 ]
12}1{
2 "manifestVersion": "2.0",
3 "settings": [
4 {
5 "name": "fc.oms.inventory.search.virtual.position.stock.status.column",
6 "value": "ACTIVE"
7 },
8 {
9 "name": "fc.oms.inventory.search.product.catalogue.default",
10 "alias": "default_pc"
11 }
12 ],
13 "routes": [
14 {
15 "type": "section",
16 "nav": {
17 "label": "i18n:fc.uvoi.nav",
18 "icon": "dashboard"
19 },
20 "pages": [
21 {
22 "type": "page",
23 "path": "inventory",
24 "component": "fc.page"
25 }
26 ]
27 }
28 ]
29}1{
2 "descendants": [
3 {
4 "component": "fc.card",
5 "dataSource": "orderById",
6 "props": {
7 "title": "i18n:fc.om.orders.detail.card.summary.title",
8 "width": "half",
9 "attributes": [
10 {
11 "label": "i18n:fc.om.orders.attribute.type.label",
12 "value": "{{type}}"
13 },
14 {
15 "label": "i18n:fc.om.orders.attribute.status.label",
16 "template": "{{status}}"
17 }
18 ]
19 }
20 }
21 ]
22}