Overview

Features are a group of related views. Views are a grouping of elements on a screen that show some type of content.

This guide shows you how to make changes to your features and views.

To find what changes you can make within some commonly used features and views, you can reference features and views for a complete list of changeable configurations, internal configurations, images, and UI text.


How To...


Change Configurations

There are two types of configurations you can edit within each feature or view: internal configurations and configurations.

  • Internal configurations affect a specific feature or view.
  • Configurations are more global and may affect multiple views.

Internal Configurations

The complete list of internal configurations is located in client/default/config/internal_configs.json.

To override an internal configuration, you must make the change in institutions/mxmobile/config/internal_configs.json. This may mean copying a section for a specific internal configuration over from client/default/config/internal_configs.json.

Configurations

The complete list of configurations is located in client/default/config/configuration.yaml.

To override a configuration, you must make the change in institutions/mxmobile/config/configuration.yaml. This may mean copying a specific configuration over from client/default/config/configuration.yaml.

For a complete list of internal configurations and configurations you can change, refer to their respective sections in the features and views reference.


Change an Image

HD and SD images are used dynamically based on the size of the phone screen and its corresponding scale factor.

When the scale factor is at or above 2, the HD images are used.

All default HD and SD images are in the client folder:

  • HD - client/mxmobile/assets/mxmobile/hd/images.
  • SD - client/mxmobile/assets/mxmobile/sd/images.

But you must override the images by placing your new images (with the same name as the one you want to replace) in the institutions folder:

  • HD - institutions/mxmobile/assets/mxmobile/hd/images.
  • SD - institutions/mxmobile/assets/mxmobile/sd/images.

For more info about which images you can change in some commonly used features and views, refer to the images sections throughout the features and views reference.


Change UI Text

The UI text is made up of strings, stored in a key-value pair format.

A complete list of keys and their matching strings is found in client/default/strings/master/en-US.json. While this list shows all the keys, you must override any changes you’d like to make by entering those keys and their edited strings in institutions/mxmobile/strings/master/en-US.json.

For a list of keys you can edit as they relate to each view, refer UI Text sections throughout the features and views reference.

To change some UI text:

  1. Open institutions/mxmobile/strings/master/en-US.json.
  2. Add a key.
  3. Set its value to your desired text.
  4. Run ./generate to regenerate en-US.json.

Here’s an example adding the USERNAME key with an empty string:

The String Table