Lucy
  • Introduction to Lucy
  • Getting Started
  • Key Components
  • Gallery (Dashboards)
    • Creating a Canvas
    • Editing Properties of a Canvas
    • Searching and Viewing Your Canvases
    • Adding Widgets onto Your Canvas
    • Customising User-created Widgets on a Canvas
    • Adjusting Widget Settings
    • Moving a Widget around a Canvas
    • Resizing a Widget on a Canvas
    • Filtering Data in a Widget
    • Deleting a Widget from Your Canvas
    • Building a Widget from Your Canvas
    • Customising a Canvas
  • My Work (Folders)
    • Creating a New Folder
    • Searching and Viewing Your Folders
    • Adding Notes related to a Folder
    • Databases
      • Understanding Databases
      • Creating and Editing Databases
        • Creating a Database Manually
        • Creating a Database by Importing Data from an External Source
        • Using an External Source as a Database
        • Editing Fields in a Database
      • Editing Data in a Database
      • Using the Database Collection Viewer
      • Searching, Filtering, and Sorting Data in a Database
      • Exporting Data from a Database
      • Utilising Content-aware Autofill to Automatically Fill in Fields in Your Database
      • Entering a Question about Databases within a Folder to Build Your Own Widget
      • Adding Data into a Database
    • User Interfaces
      • Designing a User Interface
        • Designing a User Interface to Visualise Information
        • Designing a User Interface to Capture User Feedback
        • Designing a User Interface from Scratch
      • Working with the Widget Designer
      • Selecting a Widget Template
        • Item List Widget Template
      • Viewing Your User Interfaces
      • Sharing a User Interface
      • Saving a Widget as a Template
      • Exporting a User Interface
      • Enabling Anonymous Access to a User Interface
    • Workflows and Integrations
      • Using the Workflow Editor
      • Creating Workflows
      • Creating a Workflow to Run When New Data is Added to a Database
      • Creating a Workflow to Run When an Email is Received
      • Creating a Workflow to Run When a Message from a Chatbot is Received
      • Creating a Workflow that Runs at Specified Intervals
      • Viewing and Editing Your Workflows
      • Automating Form Submission with Email Notification
      • Automating Form Submission with Slack Message
  • Add-ons
    • Installing a New Add-on in Lucy
    • Visitor Management
    • Monitoring Internal Air Quality (IAQ) at Your Workplace
    • Setting up Occupancy Analytics at Your Workplace
    • Energy Budgeting
    • Water Budgeting
    • Gas Budgeting
    • Carbon Footprint Calculation
    • Weather
  • Mobile App
    • Getting Started
    • Designing Your Mobile App
      • Working with the Mobile App Designer
      • Handling Button Click Events
      • Designing the Login Page
      • Designing the Homepage
      • Designing the Settings Page
      • Choosing a Page Type
      • Adding a New Tab to the Bottom Navigation Bar
      • Launching a Widget on Tab Click
  • Users
    • Registering a User
    • Creating a User Group
    • Searching and Viewing Users
    • Editing User Details
    • Your Profile
  • News Feeds
    • Creating a News Feed
    • Searching and Viewing News Feeds
    • Editing a News Feed
Powered by GitBook
On this page
  • Page Types
  • Choosing a Page Type
  • 1) Sections
  • 2) Widget
  • 3) Custom Mobile Page
  1. Mobile App
  2. Designing Your Mobile App

Choosing a Page Type

PreviousDesigning the Settings PageNextAdding a New Tab to the Bottom Navigation Bar

Last updated 8 months ago

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.

Type
Description

This type of page displays horizontal sections, each serving a unique purpose and enhancing the user experience.

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.

You can link a preconfigured widget to a specific tab to display it when clicked.

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.

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.

1) Sections

The 'Section' 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.

To add horizontal sections, set the Type to 'Section' when adding a tab. Other types do not support horizontal sections.

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.

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.

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.

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.

      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.

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.

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

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.

2) Widget

You can link a preconfigured widget to a specific tab to display it when clicked.

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

  6. Click Save to apply the changes. The selected widget will now display in your app under the required tab.

When adding a tab, the type should be selected as 'Widget' to link a preconfigured widget to that tab.

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

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.

When adding a tab, the Type should be selected as 'Custom Mobile Page'.

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

Click this button to open the 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.

Edit Action:
Action Editor window.
Launching a Widget on Tab Click
Designing the Settings Page
a) Custom UI Section
b) Icon Section Widget
c) Image Card List
d) Horizontal List of Cards
e) Currency Converter Widget
Sections
Widget
Custom Mobile Page
Adding a New Tab to the Bottom Navigation Bar
Choosing a Type
Adding a Custom UI section
Custom UI created
Icon Section Widget
Configured Icon Section Widget
Configuring Image Card properties screen 1
Configuring Image Card properties screen 2
An example designed using a Image Card List
An example designed using the Horizontal List of Cards section
Currency Converter Widget
Currency Converter Widget section displayed in mobile app
A example of a Widget designed
Settings page