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
  • Configuring the Home Tab
  • Selecting a Page Type
  • Configuring the App Bar Settings
  • Adding and Configuring Header Icon Buttons
  • Adding Icons to the Content Section of the Homepage
  • Customising the Navigation Bar
  1. Mobile App
  2. Designing Your Mobile App

Designing the Homepage

PreviousDesigning the Login PageNextDesigning the Settings Page

Last updated 7 months ago

The mobile app's homepage is fully customisable. You can configure the app bar by changing its colour, and height, and adding and configuring header icon buttons. If you prefer not to have header icon buttons and want larger icons, you can modify your homepage accordingly. Additionally, you can determine and configure the content displayed on the homepage.

Your mobile app comes with a default homepage and a settings page that you can customise to suit your preferences.

Configuring the Home Tab

The default home tab in the mobile app can be customised by changing its icon, name, and type.

To configure the home tab

  1. On the Lucy web app homepage, go to the Mobile App tab. Mobile app designer page displays. displays.

  2. Click the bottom navigation bar to open its properties panel.

  3. Go to the Home tab properties section.

  4. Edit the Name and Icon.

  5. : Choose the required page type to open when the respective tab is clicked, e.g., Section.

  6. Click Save.

By default, the Home tab type is set to 'Sections'. You can change the type as necessary.

Selecting a Page Type

In your mobile app, tabs are the icons located at the bottom of the page that allow you to quickly switch between different pages.

A page type determines the content displayed when a tab is clicked.

Available Page Types

  • Sections

  • Widget

  • Custom Mobile Page

Simply put, a tab can be configured to display a list of sections, a widget or a custom mobile page built using Flutter based on the selected type.

For detailed instructions on configuring the page type, read this article.

Configuring the App Bar Settings

Personalise your app bar's appearance by choosing a different color or uploading a background image, adding a company logo, including a title etc.

To configure the app bar settings:

  1. On the Lucy web app homepage, go to the Mobile App tab. Mobile app designer page displays.

  2. Under the General tab on the right, go to the Home Page tab.

  3. Customise the settings as necessary.

  4. Click Save to apply the changes in the mobile app.

  5. Open the mobile app to view changes.

These are the settings related to the app bar of your mobile app.

Adding and Configuring Header Icon Buttons

In your mobile app homepage, you can add header icon buttons to appear under app bar title. Header Icon Buttons are located at the top of a mobile app's homepage, within the app's header.

To add a header icon button:

  1. On the Lucy web app home page, go to the Mobile App tab. Mobile app designer page displays.

  2. Under the General tab on the right, go to the Home Page tab.

  3. Go to the Header Icon Buttons section and click Add Button.

  4. In the Name box, provide a suitable name for the button.

  5. Click the Icon field to pick a icon from the gallery.

  6. Configure the button to open the required page when clicked. For example, set it to open a pre-built widget.

      1. Open URL: You can configure a URL to be opened when the button is clicked.

      2. Open Widget: Used to select a specific widget to be opened when the button is clicked.

      3. Execute Action: Used to run a specific Lucy action when the button 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 button is clicked.

      5. Open Mobile Screen: Used to select a predefined mobile screen to be opened when the the button is clicked.

  7. After the configuration, Click Done.

  8. Click Save to apply the changes in the mobile app.

  9. Open the mobile app to view changes.

Adding Icons to the Content Section of the Homepage

When designing your mobile app homepage, you have the flexibility to add icons directly to the content section of the page without placing them in the app bar. This will allow you to create a visually appealing and interactive homepage with icons that link to specific content or features.

Icon Section Widget

Use an Icon Section Widget to add a collection of icons to your page. Customise each icon's background color, icon color, name, and the page that opens when clicked.

When setting up the homepage tab, make sure to select the Type as 'Section'. This allows you to add an Icon section widget to the required page.

To add an Icon Section Widget 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.

  3. In the bottom tab bar navigation, click the required tab to access your home page.

  4. Under Configure Tabs section, pick the Type as 'Section'.

  5. Go to the Sections tab on the left. Pick the Icon Section Widget.

  6. Drag and drop it onto the mobile screen.

  7. An icon section widget will be added and displayed on the mobile screen.

  8. Add a new icon

    1. An icon will be added and displayed on the mobile screen.

    2. Click the newly added icon to launch its properties panel.

    3. Click the Icon field to pick a suitable icon from the Search Icons window.

    4. Select a Background Colour.

    5. Choose an Icon Colour.

    6. In the Label box, type a unique name for the icon.

    7. Once the action is configured, click Done.

  9. Click Save. Open the home page in the mobile app to view your updates.

Customising the Navigation Bar

Customise the bottom navigation bar of your mobile app by selecting a background colour, button colour and active button colours to match your design preferences.

Steps to Customise the Navigation Bar

  1. On the Lucy web app homepage, go to the Mobile App tab. Mobile app designer page displays.

  2. Under the General tab on the right, click the Home Page tab.

  3. Select a Navigation Bar Background Colour, Navigation Bar Button Colour, and Navigation Bar Active Button Colour as necessary.

  4. Click Save. Open your mobile app to view the updates.

Click the Edit Action 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 button is clicked.

Click the Add icon.

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 the icon is clicked.

Choosing a Page Type
Type
Edit Action:
Action Editor window.
Action Editor window.
Configuring the App Bar Settings
Adding a header icon button screen 1
Adding a header icon button screen 2
Designed app bar
Set of Icons configured