In this section · 4 articles

Set up the app's menus and home dashboard

Build the app's bottom bar and side drawer menus, with icons, links, badges and targeting, and its home dashboard, from widgets or a custom screen. Then publish the dashboard.

Applies to
Core Mobile 2.0 and later
Who can do this
Platform owner
Permission
feature.cm.nav.edit
Where
Core Mobile › Navigation or App Dashboards (Platform Administration)
On this page

Before you start

  • For menus, you need Create Navigation and Edit Navigation (feature.cm.nav.create, feature.cm.nav.edit).
  • For dashboards, you need Create Mobile App Dashboard and Edit Mobile App Dashboard (feature.cm.mobile_dashboard.create, feature.cm.mobile_dashboard.edit).
  • Ask whoever builds the app for the routes, deep links, icon names and widget components it understands. A name the app doesn't know shows its fallback, or nothing.

Build a menu

1. Create the menu

  1. In the Platform Administration sidebar, select Core Mobile › Navigation.

  2. Select Create.

  3. In Menu, choose where the app shows it: Bottom bar, Drawer or Custom.

  4. Enter a Name for your team.

  5. Choose a Platform, or leave it empty for all platforms. A menu for one platform replaces the all-platforms menu of the same kind on that platform.

  6. Leave Active on.

    The Create Navigation drawer with Menu set to Bottom bar, Name entered as Main tabs, Platform left empty for all platforms and Active switched on, ready to save.
  7. Select Save.

2. Add the items

  1. On the menu's row, select Manage items. The Items screen for the menu opens.
  2. Select Add Item.
  3. Under Item, enter the Label (you can enter it in each language), choose an Icon, and enter the Route: the app screen or deep link the item opens.
  4. Under Placement, choose a Parent to put the item inside another one, or leave Top level (no parent). Set its Order.
  5. Optional: under Badge, choose Count or Dot, and a Badge key that tells the app which number to show.
  6. Optional: under Targeting, choose an Audience, a Minimum version or a Maximum version.
  7. Under Settings, leave Active on.
  8. Select Save.
The Items screen for the Student app bottom bar menu, with the Add Item drawer open on its Item, Placement, Badge, Targeting and Settings sections, empty and ready to fill in.

Each app gets only the items it matches. Hiding a parent hides everything inside it. The bottom bar ignores parents and shows its items in one row, so use parents in the drawer only.

Build the home dashboard

A dashboard is the app's home screen. You can have several: each app gets the matching published one with the highest Priority.

1. Create the dashboard

  1. Select Core Mobile › App Dashboards.

  2. Select Create.

  3. Enter a Name.

  4. In Custom component, leave None — compose widgets to build the screen from widgets. Or enter the name of a whole screen built into the app: the app then shows that screen, and ignores any widgets, their targeting and translations.

  5. Choose who gets it: Platform, Minimum version, Maximum version and Audience, as for onboarding. A dashboard with a version limit is skipped for an app that doesn't send its version.

  6. Set Status to Draft for now, and set Priority: higher wins when more than one dashboard matches.

  7. Choose Personalisation: Allowed lets each person reorder and hide widgets on their own phone. Locked ignores their saved layouts, without deleting them.

    The Create App Dashboards drawer with the name Student home entered, Status set to Draft, empty targeting and Priority fields, and the Personalisation and Active switches turned on.
  8. Leave Active on and select Save.

2. Add the widgets

  1. On the dashboard's row, select Manage widgets.

  2. Select Add Widget.

    The Add Widget drawer with Content (Title, Subtitle, Widget key), Behaviour with Type set to Chart and an empty Chart shape, Appearance (Icon, Colour, Columns, Rows) and Settings (Pinned, Active).
  3. Under Content, enter the Title and optionally a Subtitle, in each language if you need to. The Widget key is made from the title and never changes, so people's saved layouts keep working.

  4. Under Behaviour, choose the Type:

    • Stat card: a single figure.
    • Chart: also choose a Chart shape: Line, Bar, Pie, Donut or Area.
    • Custom: also enter the Custom component built into the app that draws it.

    Then enter the Data source key that supplies its figures.

  5. Under Appearance, enter an Icon name from the app's own icon set, choose a Colour (Primary, Secondary, Success, Warning, Error, Info or Neutral), and set Columns and Rows from 1 to 4.

  6. Under Settings, turn on Pinned if people mustn't hide this widget, and leave Active on.

  7. Select Save.

Drag the widgets to put them in order.

Careful: Core Mobile 2.1.0 sends each widget's description but no figures: nothing supplies the Data source values yet, so the app shows each widget's empty state.

If the dashboard uses a custom component, the Widgets screen warns that these widgets never appear in the app.

3. Publish the dashboard

  1. Edit the dashboard and set Status to Published. To start it later, set a future Publish at rather than choosing Scheduled. In Core Mobile 2.1.0, a dashboard set to Scheduled is never sent.

    The Edit App Dashboards drawer for Learner Home, with Status set to Published and highlighted, a Publish at date and time filled in and Expire at left empty.
  2. Optional: set Expire at.

  3. Select Save.

Core Mobile comes with a published example dashboard, Laramin Home. Archive it, or give yours a higher Priority.

What happens next

The app gets the new menu or dashboard the next time it asks. If it doesn't, see The app doesn't show your changes.