Skip to content

Configuring Your Mobile App Pages

To best suit your customer and product needs, we provide a variety of home dashboard page templates to customize your mobile app layout and user experience.

Styles

Currently there are eight different app styles supported:

Style Style Term
Popit List popit-list
Popit List with Image single-accordion
Large List large-list
Medium List medium-list
Small List small-list
Large Grid large-grid
Medium Grid medium-grid
Small Grid small-grid

Popit List

Popit List is the default style of ExoHome mobile app. In this template, each device is displayed in a "popit" container which can be customized to show popular device controls with an expanding behavior to reveal more settings.

Popit List with Image

This template is similar to Popit List with an additional model thumbnail image shown inside the popit container. You can define the model image from admin.

List And Grid

If you would like to support a device detail page, which can be opened by tapping on a device from the home dashboard, a variety of list and grid layouts of different sizes are provided. Choosing a list or grid style will automatically include the device detail page in your app.

Large List

Medium List

Small List

Large Grid

Medium Grid

Small Grid

Changing style

If this is a new project and to be built for the first time, You may use ~/Customer/Common/env.sh file to set the style. See this document for where to place the value.

Or open ~/src/app/app.config.ts and modify your homePage tag target value to the style term you want. Example of changing the app style to "Popit List": use home/popit-list.

Please make sure to use the proper style term name.

Style Style Term
Popit List popit-list
Popit List with Image single-accordion
Large List large-list
Medium List medium-list
Small List small-list
Large Grid large-grid
Medium Grid medium-grid
Small Grid small-grid

Thumbnail and Banner

"Thumbnail image" and "Banner image" are two UI elements for some page templates. Thumbnail will be shown on the Home Dashboard and banner will be shown in the Device Detail Page.

Thumbnail

Banner

Both of them are defined in the information model and downloaded from the cloud. When there is no network connection and app can't download the images from the cloud, app will show the placeholder image until the images are downloaded. The default placeholder image is grey background.

The placeholder images are under the src/assets/img/ folder. If you want to use your own placeholder images, you can replace the corresponding files. Both name and type of thumbnail and banner image files should be exactly the same as below.

  • Thumbnail: model_image_thumbnail.png
  • Banner: model_image_banner_placeholder.png

Note

  • Thumbnail images should be in a square resolution of at least 240 x 240 px, in PNG, JPG or GIF format with a transparent background and under 2MB.
  • Banner images should be at least 750 px wide by 240 px tall, in PNG, JPG or GIF format and under 2MB.

Have more questions? Submit a request