About the new mobile app homepage builder
Since its launch, TRIFFT included a homepage builder to real-time adjust mobile app homepages via flexible "widgets". As customer expectations grew, we decided to completely rework this module so that it reflects three desired principles:
It is WYSIWYG - i.e., you can preview the new homepage before publishing
It is more flexible - i.e., it is built so that we can add new widgets over time to support maximum flexibility
It can support multiple Channels. By "Channel", we mean for example a mobile app, but one Vendor can have multiple mobile apps or an app and a website and each might need a different homepage layout
What will happen with legacy homepages?
All apps up until version 1.4.x will use the legacy "Homepage" module to display the homepage. All app from version 1.5.0 and up will use this module to display the homepage. As we are rolling out this feature, we will make sure that you are prepared to transition to the new homepage before we upgrade production apps to version 1.5.x.
The existing Homepage module will be depreciated by 31.5.2023
Where do I find the Mobile app homepage builder?
In Content Cockpit, Setting up a homepage is a two-step process involving:
Setting up the "Mobile app" Channel under Settings > Channels
Setting up the "HOMEPAGE" setting within Mobile app Channel:
🐛 Known bug: When deleting a HOMEPAGE setting, the following error will appear:
Solution: Delete the whole Mobile app Channel and create a new HOMEPAGE setting
How do create a new or update the existing home page
Press "+ ADD NEW" button to create a new homepage "ROW"
Rows are listed in the order in which they appear on the homepage.
Live preview illustrates how the homepage will look in the mobile app when published
After creating or updating the homepage, you can Cancel, Save or Publish the result
Cancel - any changes since the last save will be lost
Save - saves changes
Publish - will cause changes to be visible to the mobile app users. (Note: changes need to be saved before they can be published)
Homepage elements: Rows and Widgets
Homepage is divided into individual "Rows". The first row starts right after the top "status bar" of the app. The last row is the last visible content on the homepage (excluding the bottom icon bar).
Rows take up the whole width of the screen and have different heights. There are no vertical gaps between rows (also these can visually be created with "Spacers" widgets).
Each row serves as a container for one or more "Widgets". Widget represents a certain type element that has a purpose, function, some general appearance, and functional and visual settings.
Current widgets include:
Static Two Column
Editing homepage elements
Up and Down arrows: change the order of Rows
Bin icon: Delete Row
Expand icon: Expands settings for a particular Row
Title is shown both on the list in Content Cockpit and (optionally) as a Row title on the homepage (see item #3)
Widget type: select a widget that you wish to add to homepage
Display title: allows you to display the title text on the homepage
Background: select color for the whole ROW background. Note: most widgets allow to select widget background color, be aware, that while ROW always represents a full-width rectangle, widgets may have margins or take up only a portion of the row.
Default (as per the overall mobile app setting)
Transparent (no color set, app background color (typically white) is displayed
Solid color - copy paste color hex code or use color picker to set color
Consult support article for individual widget types.