All Collections
Content Management
New mobile app homepage builder
New mobile app homepage builder

This support article explains in detail how to use the new app homepage builder, available in production from Apr 2023.

Updated over a week ago

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:

  1. It is WYSIWYG - i.e., you can preview the new homepage before publishing

  2. It is more flexible - i.e., it is built so that we can add new widgets over time to support maximum flexibility

  3. 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:

  1. Setting up the "Mobile app" Channel under Settings > Channels

  2. 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

  1. Press "+ ADD NEW" button to create a new homepage "ROW"

  2. Rows are listed in the order in which they appear on the homepage.

  3. Live preview illustrates how the homepage will look in the mobile app when published

  4. After creating or updating the homepage, you can Cancel, Save or Publish the result

    1. Cancel - any changes since the last save will be lost

    2. Save - saves changes

    3. 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

  • Side-by-side images

  • Static Counter

  • Feeds

  • Contest

  • Spacer


Editing homepage elements

  1. Up and Down arrows: change the order of Rows

  2. Bin icon: Delete Row

  3. Expand icon: Expands settings for a particular Row


Row settings

  1. Title is shown both on the list in Content Cockpit and (optionally) as a Row title on the homepage (see item #3)

  2. Widget type: select a widget that you wish to add to homepage

  3. Display title: allows you to display the title text on the homepage

  4. 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.

    1. Default (as per the overall mobile app setting)

    2. Transparent (no color set, app background color (typically white) is displayed

    3. Solid color - copy paste color hex code or use color picker to set color


Widget settings:

Consult support article for individual widget types.

Did this answer your question?