IDevice Layouts

On an iDevice, the first page that subjects usually see is the Subject Dashboard.  This dashboard is composed of a collection of cards.  Each card presents content that is relative to the subject and their health care needs.  Cards are formatted based on their content and the size constraints specified for the card by the user.  The content of a card is determined by selecting one of the available features for the card to be placed on the display.

Menu and Menu Option are the most often used “features”.  These cards allow the layout designer to specify a graphic, a title and some sort of description that displays on the card and the card is either configured to start an applet (Menu) or bring up another dashboard (Menu Option)

iDevice layouts support 3 different sizes… Tablet Portrait, Tablet Landscape and Phone Portrait.  The amount of room to present cards changes based on these three sizes.  For example, there is more “width” to the tablet landscape layout and less “height” than, say, the tablet portrait size.

The user configures the size of cards in “units”.   Using “units” allows the device to fit the cards on the display regardless of the actual number of pixels available making layouts device size agnostic and allowing the system to limit the amount of knowledge the user must have of the target device in order to select card sizes for the layout.  Rather than having to know the pixel resolution of the device in use by the subject, the layout designer simply needs to know whether the layout is being used for tablets or phones and whether or not it is in landscape or portrait mode.

Note that as of this writing, a phone running m.Care does not support phone landscape orientation. As such, the layout tool does not support this size.

The following screen clip shows the Layout Tool for iDevice layouts.

The options that are most often used appear on the front page of a page that displays a sub-notebook.  The subnotebook has the following tabs:

  1. Features – This is the area where the “cards” are selected for the layout.  
  2. Colors – Most often the motif dictates the colors of the dashboard but it is still possible to override this behavior by using the colors tab and selecting the colors that are in effect when the dashboard app is displayed.
  3. Toolbar Options – This tab actually calls out for the user to determine which toolbar features they want activated when the dashboard displays.
  4. Effects – A very low use feature that allows the designer to add special effects to the dashboard if so desired.

Layout Style

New to the layout tool is a drop down that allows the user to select from a set of pre-formatted layout styles.  These styles tell the iDevice applications how to arrange the cards as they are presented to the user.  The new layout tool supports extending the number of layout styles available as the iDevice support grows.

Best Fit Style

Currently, the only layout style available for the iDevice is a “best fit” style.  This style takes the cards and sizes into account along with an order preference and displays the cards in a mosaic pattern such that the cards effectively fill up the space of the layout.  

Features Sub Tab

The features sub tab is where the user spends most of their time when working out a layout for the iDevice. This tab allows the user to select which cards they’d like to display, the size of the card and the order in which the card will display.   

1.1.1     Choosing the Layout Size

A screen shot of an open computer

Description automatically generated

The layout size is selected in the drop-down list on the features tab.  You indicate which size of the layout you are working on in this drop-down list.  If you change the size, the features list automatically refreshes to show you only the cards that are to be displayed in that layout size.  For example, you may elect to use more cards on the tablet display than you do on the phone because of the size of the device.   

1.1.2     Feature

Use the feature drop down to select the “card” that will display on the dashboard given the layout and size.  There are numerous cards to choose from.  A list of those known at the point of this writing are provided in the appendix of this document entitled “Available Cards for iDevice Display”


The features you select are listed in the order in which they will be displayed.  In some styles, the order strictly selects where each card displays.  In other styles, such as “Best Fit”, the order acts more as a priority for where the card will display.


You can use the arrows next to the card to move the cards display order up, down, to the top or to the bottom.

Width and Height

The user may specify the size of each card in card units.  Depending on the “Style” selected for the dashboard, the sizes may or may not be needed to be entered by the user.

The default style of “Best Fit” DOES require the sizes to be specified by the user.  The height and width of each card shown can be set given the layout size being edited.  For example, you can set different card sizes for iPhones than iPads.

Some styles may not require sizing information as the size may be pre-built into the style.  As such, the features tab may hide the sizing options from the user in that instance.



The user clicks Revise to specify options associated with the feature of the card.  For example, clicking Revise allows the user to specify, say, the Title, Icon and Description of a menu card.  There are several options that can be tailored and the options vary by feature type.


By clicking Remove, the card is removed from the layout.


The “order” column can be easily renumbered, allowing a designer to specify cards that should be placed in between other cards, by clicking the “Reorder” button, which appears above and to the top right of the Features list

Copy Layout Items

The Copy Layout Items button displays to the top and right of the features list.  When you click this button, the system asks whether or not you’d like to copy features from another “size” within the existing layout. An example of use for this is when creating a new dashboard.  Typically, people start out creating a dashboard for Tablet Portrait mode.  Once done, they can import that same feature list, order and sizing into the Tablet Landscape mode.  Once copied, the designer often re-orders the features or changes size, but by using the Copy Layout Items button, they can at least start from the same list of features that they defined in one of the other sizes.

Delete All Features

By clicking this button, and answering the confirmation prompt that is presented, the user can request that the system remove all features that have been specified for the layout/size.  This button DOES NOT remove the features on a different layout size… just the currently selected size is affected.

Feature Options

When the user clicks the “Revise” link next to a feature on a dashboard layout, the “Dashboard Item View” page is displayed.  This page allows the layout designer to adjust the way certain features behave. The options that can be adjusted varies by feature type.  For example, not all features support the starting of an applet when they are touched.

The following screen clip shows the content of the page when editing the standard Menu Option feature.

A screenshot of a computer

Description automatically generated


The options presented vary based on the feature being configured.   The standard options available on many cards are described here:


The title that displays on the card.   Titles are displayed commonly on one line.  See Appendix 2 for replacement variables available within Titles.


The descriptive text that is used to briefly tell the subject what tapping on the card will do. When cards are presented, the subtitle text typically wraps to fill the space available. See Appendix 2 for replacement variables available within SubTitles

Card Style

This option is associated with the Menu and Menu Option feature.  It allows the layout designer to configure the placement of the icon, title and descriptive text of the card.

Icon Option

Specifies where the icon for the card should come from.  Options include among others, using a specified icon, or using a system supplied Icon.  If you use a specified icon, the recommended size is 64×64 and no more than 128×128. It is best to keep the icon square so that it appears consistently across resolutions.  Large icons dramatically affect overall system performance. Whereas the system may allow it at this point, the user is encouraged to use no graphic larger than 128×128 pixels. In the future, the icon size will most likely be limited to no larger than 128×128.  Larger sizes should be considered “deprecated”.

Highlight Number Phrase

This field indicates whether or not the card should be tagged.   A tagged card displays a number in the top right corner of the card.  An example of the tag usage might be to reflect the number of messages waiting for the user to retrieve.

The system supports a variety of “phrases” that can be used to determine the value of the tag.  For example, on a card that is working with messages, perhaps using the tag #MessagesWaiting within the Highlight Number Phrase option would be useful.  In so doing, the system displays a small red oval to the top right of the card with the number of messages waiting for the user to review.

Replacement Phrases


























#UnopenedBooks – Number of books not opened yet

#SurveysWaiting  – Number of surveys needing answers

#MessagesWaiting – Number of unread messages

#Points – Points earned by subject for the lab

#LongDayAndDate – for example, Tuesday, 1/12/2021 

#ShortDayAndDate – for example, Tue, 1/12/2021

#CareTeamContactInfo – This pulls from the Care Team: Advanced Team Options field

#KeyDateDate (Note the use of the word Date is repeated. The key date name is all caps of the key date description with the spaces and special characters removed) – for example, My name is #FIRSTNAME and I have been sober since #KeyDateDateLASTSOBRIETYDATE

#KeyDateTill – for example, My Name is #FIRSTNAME and there are #KeyDateTillSURGERY days till my surgery

#KeyDateSince – for example, My name is #FIRSTNAME and I have been sober #KeyDateSinceLASTSOBRIETYDATE days

#MOSTRECENTVITALS – displays the most recent values of all of the (common) measurement types from the CURRENT DATE

#LBS – Last weight in pounds

#BP – Last blood pressure

#PO2 – Last SPO2

#HEARTRATE- Last Heart Rate

#GLUCOSE – Last Glucose 

#TEMP – Most recent termperature

#SLEEPDURATION – Minutes of sleep

#Steps – Steps counted on this day

#CaloriesConsumed – Calories consumed on this day

#DailyOutput – Number of outputs (baby usage)

#THADAlarmTime – Displays the time for the alarm set into a subject’s THAD device

#THADAlarmStatus – The status of the alarm (on or off)

#THADAlarmStatement – Spells out if the device has an alarm set and if so what the time is

#THADAlarmShortStatement – Spells out briefly the device alarm setting

#THADUnseenAlerts – Number of alerts not yet seen by this caregiver on this patient

#THADAlert Summary – The alert summary text generated by the system. For use on the THAD alert card only.

#THADBatteryPercentage -Battery percent available as last reported by the THAD device

#THADBatteryDate – Last time the THAD device reported the battery percent

#THADLastCheckedInDate – Last time the user “checked in”via THAD device

#THADWhereAt – Either “Home” or “Unknown”

#THADSteps – Number of steps as tracked by the THAD device for that day

#THADSteps – Number of steps as tracked by the THAD device for that day

#THADStepsGoal – Goal number of steps

#THADStepsPercent – Percent complete towards THAD steps goal