> For the complete documentation index, see [llms.txt](https://help.iviva.com/lucy/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.iviva.com/lucy/mobile-app/designing-your-mobile-app/choosing-a-page-type.md).

# Choosing a Page Type

## Page Types

A page type determines the content displayed when a tab is clicked in your mobile app's bottom navigation bar. These are the available page types.

<table><thead><tr><th width="306">Type</th><th>Description</th></tr></thead><tbody><tr><td><a href="#id-1-sections">Sections</a></td><td><p>This type of page displays horizontal sections, each serving a unique purpose and enhancing the user experience.</p><p>These are the available sections: Custom UI Section, Icon Section Widget, Image Card List, Horizontal List of Cards, Currency Converter Widget, and Configurable Search Widget.</p></td></tr><tr><td><a href="#id-2-widget">Widget</a></td><td>You can link a preconfigured widget to a specific tab to display it when clicked.</td></tr><tr><td><a href="#id-3-custom-mobile-page">Custom Mobile Page</a></td><td>Custom Mobile Pages are unique to the mobile app and not available in the Lucy web app. Although the mobile app is set up through the Lucy web platform, these pages are specifically designed for mobile, e.g., Settings page.</td></tr></tbody></table>

In summary, a tab can be configured to display a list of sections, a widget or a custom mobile page built using Flutter.

## Choosing a Page Type

Select a page type when adding a new tab to your mobile app's bottom navigation bar.

{% content-ref url="/pages/fQTVPDZyohuR1IrGK2ga" %}
[Adding a New Tab to the Bottom Navigation Bar](/lucy/mobile-app/designing-your-mobile-app/adding-a-new-tab-to-the-bottom-navigation-bar.md)
{% endcontent-ref %}

<figure><img src="https://333252015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTG5DCdGHEfzVksM49xh8%2Fuploads%2FNjsu9Klay7D7dsFgiUvm%2FAdding%20a%20new%20tab_2.png?alt=media&amp;token=96968ac8-2b10-4476-9b97-ca87b7dd03e2" alt="" width="259"><figcaption><p>Choosing a Type</p></figcaption></figure>

### 1) Sections

The 'Sectio&#x6E;**'** page type lets you effortlessly add horizontal sections to your mobile app's pages. These sections are pre-designed UI elements that you can simply drag and drop.

By using these pre-designed sections, you can quickly add various functionalities and visual elements to your app without extensive coding knowledge. This means you can create a more visually appealing and interactive app with less effort.

Below are the available sections. You can add the same section multiple times if needed.

[a) Custom UI Section](#a-custom-ui-section)

[b) Icon Section Widget](#b-icon-section-widget)

[c) Image Card List](#c-image-card-list)

[d) Horizontal List of Cards](#d-horizontal-list-of-cards)

[e) Currency Converter Widget](#e-currency-converter-widget)

{% hint style="info" %}
To add horizontal sections, set the **Type** to 'Section' when adding a tab. Other types do not support horizontal sections.
{% endhint %}

#### a) Custom UI Section

Use the Custom UI Section to create a personalised user interface with JSON code.

To add and configure a Custom UI Section:

1. On the Lucy web app homepage, go to the **Mobile App** tab. Mobile app designer page displays.
2. Click the bottom navigation bar.
3. In the bottom navigation bar, click the required tab.
4. Go to the **Sections** tab on the left.
5. Drag and drop the '**Describe a custom interface with a special interface language'** section on to the desired area on the mobile screen.
6. A horizontal section named Custom UI will appear on the mobile screen.
7. Click the **Custom UI** section to open its properties panel.
8. In the **Custom UI (Mobile**) field, enter the JSON code of the UI you want to build.
9. Configure the **Data source.**
   1. Click the **Bind a Source** button.
   2. You can select an existing Lucy action or a database as the data source.
10. Click **Save** to apply the changes in the mobile app.

<figure><img src="https://333252015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTG5DCdGHEfzVksM49xh8%2Fuploads%2FcXxr15hpycmHljCRemC6%2FAdding%20a%20Custom%20UI%20section_2.png?alt=media&amp;token=9e3a5fbc-9029-4275-8acd-0aef6a1a6968" alt="" width="430"><figcaption><p>Adding a Custom UI section</p></figcaption></figure>

<figure><img src="https://333252015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTG5DCdGHEfzVksM49xh8%2Fuploads%2FTRVlpFdaSrrFvJbeUyui%2FCustom%20UI%20created_3.png?alt=media&amp;token=19498328-96f1-4fad-80b7-b132859a603d" alt="" width="353"><figcaption><p>Custom UI created</p></figcaption></figure>

#### b) Icon Section Widget

You can include a set of icons using an Icon Section Widget. Configure each icon by setting its background colour, icon colour, name, and the action to be executed when clicked.

You can customise an icon section widget by adding a title, changing colours, and adjusting size. Additionally, you can modify the icon shape (e.g., square, circle), background colour, text colour, etc.

{% hint style="info" %}
To customise the title section of the icon section widget, click the title section to launch its properties panel.

To customise the body section of the icon section widget, click the body section to launch its properties panel.
{% endhint %}

To add a Icon Section Widget:

1. On the Lucy web app homepage, go to the **Mobile App** tab. Mobile app designer page displays.
2. Click the bottom navigation bar.
3. In the bottom navigation bar, click the required tab.
4. Go to the **Sections** tab on the left.
5. Pick the **Icon Section Widget.** Drag and drop it onto the mobile screen.
6. An icon section widget will be added and displayed on the mobile screen.
7. Add a new icon
   1. Click the **Add** icon.
   2. An icon will be added and displayed on the mobile screen.
   3. Click the newly added icon to launch its properties panel.
   4. Click the **Icon** field to pick a suitable icon from the Search Icons window.
   5. Select a **Background Colour.**
   6. Choose an **Icon Colour.**
   7. In the **Label** box, type a unique name for the icon.
   8. [**Edit Action:** ](https://help.iviva.com/lucy/mobile-app/designing-your-mobile-app/handling-button-click-events)Click this button to open the [**Action Editor** window.](https://help.iviva.com/lucy/mobile-app/designing-your-mobile-app/handling-button-click-events#action-editor-window) This window has five tabs: Open URL, Open Widget, Execute Action, Open Add-on, and Open Mobile Screen. Use these tabs to set what happens when a specific icon is clicked.
      1. **Open URL:** You can configure a URL to be opened when the icon is clicked.
      2. **Open Widget:** Used to select a specific widget to be opened when the icon is clicked.
      3. **Execute Action**: Used to run a specific Lucy action when the icon is clicked. You can select a model, choose an appropriate action, and provide parameters. Additionally, configure the post-action behavior.
      4. **Open Add-on**: Used to configure a specific add-on to be opened when the icon is clicked.
      5. **Open Mobile Screen**: Used to select a predefined mobile screen to be opened when the the icon is clicked.
      6. After configuring the action, Click **Done**.
8. Click **Save** to apply the changes in the mobile app.

<figure><img src="https://333252015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTG5DCdGHEfzVksM49xh8%2Fuploads%2FyCyc4ruDYaM39o5B0NAM%2FIcon%20Section%20Widget_1.png?alt=media&amp;token=55bed564-5615-4888-9da3-050fe6cdc43e" alt=""><figcaption><p>Icon Section Widget</p></figcaption></figure>

<figure><img src="https://333252015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTG5DCdGHEfzVksM49xh8%2Fuploads%2F3mPRkx0lW1LsFmdYs1eq%2FIcon%20Section%20Widget%20customised_1.png?alt=media&amp;token=2c508a3f-b7e0-47e6-a630-2aadbd102e71" alt=""><figcaption><p>Configured Icon Section Widget</p></figcaption></figure>

#### c) Image Card List

An image card list is a vertical stack of cards, each containing an image, text and potentially clickable elements like clickable images, links. Users can scroll through the list to view all cards. This layout is widely used in mobile apps to display items in a structured and visually appealing manner.

Common Use Cases: Product Galleries, Photo Albums, Article Feeds

To add a Image Card List:

1. On the Lucy web app homepage, go to the **Mobile App** tab. Mobile app designer page displays.
2. Click the bottom navigation bar.
3. In the bottom navigation bar, click the required tab.
4. Go to the **Sections** tab on the left.
5. Pick the **Image Card List.** Drag and drop it onto the mobile screen.
6. An image card list will be added and displayed on the mobile screen.
7. Customise the title of the image card list.
   1. Click the Title section of the card list to launch its properties panel.
   2. In the Text field, type in a suitable title.
   3. Choose a title colour.
   4. Adjust the title size as necessary.
8. Customise the image card list section.
   1. Click on the image card to launch its properties panel.
   2. Do required customisations.
9. Add a new card to the Image Card List.
   1. In the image card list, click the add icon.
   2. A new card will be added to the image card list.
   3. Customise the new card as needed.
10. Click **Save** to apply changes in the mobile app.

<figure><img src="https://333252015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTG5DCdGHEfzVksM49xh8%2Fuploads%2FtDgbU50BoHtICNa72ccr%2FConfiguring%20Image%20Card%20properties_1.png?alt=media&amp;token=a434c9dc-9364-41b5-96b5-6a4bdbd6e30d" alt=""><figcaption><p>Configuring Image Card properties screen 1</p></figcaption></figure>

<figure><img src="https://333252015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTG5DCdGHEfzVksM49xh8%2Fuploads%2FLL8wvPO4VAvuKxzGvAth%2FConfiguring%20Image%20Card%20properties_2.png?alt=media&amp;token=04c643fb-e67c-4e1d-8a82-aab706da578a" alt=""><figcaption><p>Configuring Image Card properties screen 2</p></figcaption></figure>

<figure><img src="https://333252015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTG5DCdGHEfzVksM49xh8%2Fuploads%2FGPIbVckaRFfeNvNlNVTn%2FImage%20Card%20List_1.jpg?alt=media&amp;token=c8b1c091-1aca-40f2-8850-3296110db879" alt="" width="563"><figcaption><p>An example designed using a Image Card List</p></figcaption></figure>

#### d) Horizontal List of Cards

A horizontal list of cards is a layout where cards are arranged side by side, horizontally, instead of vertically. This arrangement allows users to swipe horizontally to view additional cards. Only a limited number of cards are visible at once, encouraging users to actively explore the content.

In addition, you can bind a data source to a card list, dynamically populating the cards with relevant information. Also you can customise the appearance and content of each card, including images, text labels, and buttons.

Common use cases: Carousel sliders, Featured content, Image galleries

Steps to Add a Horizontal List of Cards to a Page

1. On the Lucy web app **homepage**, go to the **Mobile App** tab. Mobile app designer page displays.
2. Click the bottom navigation bar of the mobile screen displayed.
3. In the bottom navigation bar, click the required tab to open required page on the mobile screen.
4. Go to the **Sections** tab on the left.
5. Pick the **Horizontal List of Cards.** Drag and drop it onto the mobile screen.
6. Edit the Title section as necessary.
   1. Click on the Title section and its properties panel will open on the right.
   2. Under the **Container** section, pick a background color for the section.
   3. Under the **Title** section, add a suitable title, customise the colour and the size.
   4. Under the **Subtitle** section, add a subtitle and customise its properties.
7. Customise the image card list.
   1. Click on the card list to open its properties panel.
   2. Under the Card List section, choose the card type.
   3. Bind a data source to the card list. You can bind an existing lucy action or a database.
   4. Based on the data source selected, data will be populated in each card.
8. Add Top Labels and buttons and Bottom Labels and buttons to appear in each card.
   1. Add a button.
      1. Click the plus icon at the top or bottom of the card.
      2. To select a button, pick the Button option from the list and click Save.
      3. Go to properties panel and enter a proper button title.
      4. Edit Action butto&#x6E;**:** Used to open the action editor window. This window has five tabs: Open URL, Open Widget, Execute Action, Open Add-on, and Open Mobile Screen. Use these tabs to set what happens when a specific section is clicked.
      5. Customise the button properties e.g., Background Colour, Font Size as necessary.
      6. Add more buttons if necessary.
   2. Add a Text Label.
      1. Click the plus icon at the top or bottom of the card.
      2. To select a text label, pick the Text Label option from the list and click **Save**.
      3. Click on the newly added label to open its properties section.
      4. Choose the required design of the label: Default style or Pill Style.
      5. Under Text/Label section, in the Text field, type in the text to appear in the label.
      6. Customise the label properties as necessary.
      7. Add more text labels if necessary.
9. Click **Save** to reflect the changes in the mobile app.

<figure><img src="https://333252015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTG5DCdGHEfzVksM49xh8%2Fuploads%2FsfVlcCV0qDsCy5FMUSAY%2FHorizontal%20List%20of%20Cards.jpg?alt=media&amp;token=7f67092a-951c-40f8-bb0b-88e26317e471" alt="" width="563"><figcaption><p>An example designed using the Horizontal List of Cards section</p></figcaption></figure>

#### e) Currency Converter Widget

A **Currency Converter Widget** is a interactive element that allows you to easily convert amounts from one currency to another providing real-time exchange rates and calculations.

To add a Currency Converter Widget to a mobile page:

1. On the Lucy web app homepage, go to the **Mobile App** tab. Mobile app designer page displays.
2. Click the bottom navigation bar.
3. In the bottom navigation bar, click the required tab.
4. Go to the **Sections** tab on the left.
5. Pick the **Currency Converter Widget.** Drag and drop it onto the mobile screen and it will appear on the mobile screen.
6. Click **Save** to apply the changes in the mobile app.
7. Open your mobile app and go to the required tab. The Currency Converter section will be displayed.
8. In the Currency Converter section, select the original currency (*e.g., USD)* and enter the amount you want to convert.
9. Choose the currency you want to convert the original amount into (*e.g., SGD)*. The entered amount will be automatically displayed in the selected currency.

<figure><img src="https://333252015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTG5DCdGHEfzVksM49xh8%2Fuploads%2FBQ2cK8gykylvj7x2nuFk%2FCurrency%20Converter%20Widget_1.png?alt=media&amp;token=4a78b97e-3b15-4b97-8911-b3f5e913e263" alt=""><figcaption><p>Currency Converter Widget</p></figcaption></figure>

<figure><img src="https://333252015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTG5DCdGHEfzVksM49xh8%2Fuploads%2Fo5PtjYNz1bO7CT3A6H5I%2FCurrency%20Converter%20Widget_2.png?alt=media&amp;token=44c487a6-3638-4790-b5e8-3002f8b8492a" alt="" width="530"><figcaption><p>Currency Converter Widget section displayed in mobile app</p></figcaption></figure>

### 2) Widget

You can link a preconfigured widget to a specific tab to display it when clicked.&#x20;

To link a widget to a specific tab:

1. On the Lucy web app homepage, go to the **Mobile App** tab. Mobile app designer page displays.
2. Click the bottom navigation bar.
3. In the bottom navigation bar, click the required tab.
4. Click the **Select a Widget** button.
5. Pick the required widget from the list (widget names will appear in the list).&#x20;
6. Click **Save** to apply the changes. The selected widget will now display in your app under the required tab.

{% hint style="info" %}
When adding a tab, the type should be selected as 'Widget' to link a preconfigured widget to that tab.
{% endhint %}

Learn to build and link a widget to a tab. Find the article here to gain more insights:

{% content-ref url="/pages/isi7PfGEqZtRyFzyFTCv" %}
[Launching a Widget on Tab Click](/lucy/mobile-app/designing-your-mobile-app/launching-a-widget-on-tab-click.md)
{% endcontent-ref %}

<figure><img src="https://333252015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTG5DCdGHEfzVksM49xh8%2Fuploads%2FRHPmsLP6f7l0qyLjjwua%2FWidget%20example_3.png?alt=media&amp;token=bfd9a894-b864-4e9e-b470-bbc9b1e946b0" alt="" width="353"><figcaption><p>A example of a Widget designed</p></figcaption></figure>

### 3) Custom Mobile Page

Custom Mobile Pages, such as the Settings page, are unique to the mobile app and not available in the Lucy web app.

You can organise the settings page by configuring Setting Groups and configuring related Sections within each group.

{% hint style="info" %}
When adding a tab, the **Type** should be selected as 'Custom Mobile Page'.
{% endhint %}

<figure><img src="https://333252015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTG5DCdGHEfzVksM49xh8%2Fuploads%2FcJOEmGvhl2lmJRCpGXXQ%2FSettings%20screen_2.png?alt=media&amp;token=877e3ac8-2806-42ae-a91c-2e7ad96cf2eb" alt="" width="353"><figcaption><p>Settings page</p></figcaption></figure>

Here is an example for designing a page using the 'Custom Mobile Page' type.

{% content-ref url="/pages/4YBJ1V9NClDoF2pNfzkn" %}
[Designing the Settings Page](/lucy/mobile-app/designing-your-mobile-app/designing-the-settings-page.md)
{% endcontent-ref %}