Navigation
The frame of a tenant's app: its tabs, the button in the home header, the rows in Settings and the tabs inside Explore.
nav.tabs
A list with one entry per tab, { key, visible, labelOverride, iconOverride }; the list's order
is the bar's order. The keys are home, explore, progress, chat and settings, and a
renamed tab still opens the same screen.
- An unknown key is left out of the bar, so a misspelt key looks like a hidden tab.
- Hiding a tab also turns off every link to it: a push or a button aimed at a hidden tab does nothing. A participant on a tab that is hidden moves to the first visible one.
- Hiding
homechanges the screen the app opens on to the first visible tab. - An unrecognised icon name draws the tab's default icon. A value that can't be read at all gives the five default tabs.
home.action
The one button in the home header, which can put a tenant's own booking link, web page or phone
number in front of every participant. label, icon (from a short vocabulary; unknown draws the
default), sheetTitle, color/onColor (leave both out to use the palette), and items. One
item opens straight away; two or more open a sheet. The button shows only when at least one
item can be tapped; a new tenant's list is empty.
Item type | Fields | Tapping it |
|---|---|---|
booking | label, flow, note | Opens the tenant's booking flow, signed in |
web | label, url (https:// only), note | Opens the page inside the app |
phone | label, number (digits and a leading + only), note | Opens the dialler |
text | text | Nothing; a line of explanation |
- An item with an invalid field doesn't show, silently: a plain
httpaddress, a number with spaces, abookingwith noflow. A field over its length is dropped, not trimmed. - Any item can carry group codes, and only members of one of those groups see it. The platform removes the others before the list leaves it. Someone left with no tappable item sees no button.
settings.links
Rows in a Services section of the Settings screen, written exactly as home.action's items,
group codes included. An empty list shows no section.
explore.tabs
The tabs inside Explore, at most eight: the platform's own discovery tab, a web tab with a
url, or a webSso tab that hands the participant to an outside service signed in (through the
booking hand-off). A list with no native tab gets the discovery tab added in front.