Dev GuideAPI Reference
Dev GuideAPI ReferenceUser GuideGitHubNuGetDev CommunitySubmit a ticketLog In
GitHubNuGetDev CommunitySubmit a ticket

Keep mobile in mind

Describes considerations for the Commerce (SaaS) Mobile App when developing Commerce (SaaS) extensions.

To help you plan for and build Commerce (SaaS) extensions that will work with the Commerce (SaaS) Mobile App both now and/or in the future, consider the following scenarios when approaching development.

Optimizely recommends adding custom business logic on the API and/or server side first. Assess the impact of these customizations to ensure they work well on both your Commerce (SaaS) website and the Mobile App before exploring other ways of extending the system or business logic.  Remember that the UI of the Mobile App is not all extensible, so custom changes in the website's UI will not carry over to the Mobile App.

Scenario - Custom field required to submit orders

You add a custom field to the Commerce (SaaS) storefront and want to require it to have a value before customers can submit orders. You change the relevant API endpoint to accommodate for and require the new field.

Considerations

While we don't prevent you from adding custom fields to an API, consider:

  • Commerce (SaaS) websites and the Mobile App have separate user interfaces, so anything you customize (including adding fields) on the storefront does not cascade to the Mobile App i.e. Themes, JavaScript, CSS, etc.
  • For example, adding a new, required property on an API endpoint can be implemented in the storefront but not in the Mobile App
  • Explore alternatives like making the new property on the API optional and adding in additonal logic to handle the mobile application instance

Scenario - Product availability messages

Commerce (SaaS) passes a product availability message to your customers as a string of data through an API. You want to format this message so it's easier for your customers to read. You put logic on the storefront side to insert pipes to parse the message when it displays to customers.

Considerations

While using pipes in the storefront logic to parse the data string doesn't break anything, consider:

  • Commerce (SaaS) websites and the Mobile App have separate user interfaces, so anything you customize (including formatting data strings) on the storefront does not cascade to the Mobile App i.e. Themes, JavaScript, CSS, etc.
  • The Mobile App will continue to use the data string and display the product availability message as-is to your customers
  • Explore alternatives like adding logic to the relevant API if you want to expose additional values for use on both your Commerce (SaaS) website and Mobile App