Skip to main content

Designing a mobile app experience

4 Tasks

15 mins

Visible to: All users
Beginner Pega Platform 8.7 Mobile English
Verify the version tags to ensure you are consuming the intended content or, complete the latest version.


GoGoRoad wants to allow customers to create an assistance request case from their mobile device. Customize the User mobile app channel to design a mobile app experience that lets customers: 

  • Create an assistance request case
  • Check any notifications sent to the customer
  • Update details on an assistance request case
  • Update the location for an assistance request case
  • Log off

In addition, customize the app branding, including the launch screen and app icon, and configure the app to lock after three minutes of inactivity. 

The following table provides the credentials you need to complete the challenge.

Role User name Password
Application Developer author@gogoroad pega123!
Note: Your practice environment may support the completion of multiple challenges.  As a result, the configuration shown in the challenge walkthrough may not match your environment exactly.  

You must initiate your own Pega instance to complete this Challenge.

Initialization may take up to 5 minutes so please be patient.

Challenge Walkthrough

Detailed Tasks

1 Configure navigation for the app menu

  1. In the navigation pane of App Studio, click Channels to access the multi-channel configuration. 
  2. In the Current channel interfaces section, click User Mobile App to begin working on the mobile application.
  3. Click Enable it to activate the Mobile Authentication Service.
    The Mobile Authentication Service activation ribbon.
  4. In the Navigation section, select the gear icon next to Create action. 
  5. Rename the Action Name to Create case.
  6. Under Case types, confirm that Assistance Request is selected and click Submit.
  7. In the Navigation section, click Add > List pages > Assistance Request list to add a new page to the navigation menu.
  8. In the Navigation section, drag the handle icons to reflect the following order: Assistance Request list, Create case, Notifications, Log off. 
  9. In the Navigation section, click the Delete icon in the remaining item rows so that the Navigation section resembles the following image.
  10. In the mobile app preview, confirm that the bottom navigation has only four options. 

2 Add actions for the Assistance Request cases

  1. On the Content tab, click List pages, and then Assistance Request list to access the Assistance Request list page settings.
  2. In the Swipe actions area, in the Left side actions section, to the right of Follow, click the Delete icon to remove the swipe action.
  3. In the Left side actions section, click Add, and then Identify location to add the swipe action.
    Note: With version 8.7 of Pega PlatformTM, left and right side action options are configured as case-wide optional actions in the case designer. For more information, see Authoring mobile list pages.
  4. To the right of Identify location, click the Gear icon to open the Edit settings dialog box.
  5. In the Edit settings dialog box, click Change to access the Icon class picker window.
  6. In the Icon class picker window, in the Search field, enter pi-location.
  7. In the Icon class picker window, select the pi-location icon, and then click Submit to close the Edit settings dialog box.


3 Configure app name, description, and security

  1. On the mobile channel page, select the Configuration tab and click the General category.
  2. In the Mobile app name field, enter Roadside Assist to rename your mobile app. 
  3. In the Description field, enter Help is never far away with Roadside Assist!.  
  4. In the Select role list, select Author to grant access to the Author role for this channel. 
  5. In the left menu navigation, select the Security category.
  6. In the Authentication and Security settings section, enter 3 as the time-out value in the Lock app after x minutes of inactivity field.

4 Customize the app branding

  1. On the Layout tab, click the Branding category to configure branding options. 
  2. Hover your pointer over the Launch screen area to display a Change box.
  3. Click Change to open the Launch screen window.
  4. In the Launch screen window, click the Icon tab to select a launch screen icon. 
  5. In the Select icon area, click the gauge icon to select it as your launch screen icon.
  6. Click Generate to add the icon to the Roadside assist app.
  7. Repeat steps 2-6 to change the App icon. 
  8. Click the Theme category to configure your mobile app's theme.
  9. In the Mobile specific colors section, click the swatch to the right of Mobile bottom navigation.
    Color Theme selections for User Mobile App
  10. In the color swatch window, select white, or enter the Hex value #FFFFFF.
  11. Click Save to make your selection and dismiss the color swatch window.
  12. Repeat steps 9-11 to change the color for Secondary swipe action and Primary button to dark green, or enter the Hex value #064F2E.
  13. Repeat steps 9-11 to change the color for Footer text & icon to blue, or enter the Hex value #006BBD.
  14. In the mobile app preview, confirm your color changes.
  15. In the main App Studio window, click Save to save your changes.
    Mobile Assist mobile app preview

Confirm your work

Caution: Pega Mobile Preview requires you to update the password for author@gogoroad. You need the updated password to log into the following challenges: Calculating fields using decision tables and Creating users and roles.
  1. Install Pega Mobile Preview from your device-specific app store (App Store for iOS or Google Play for Android). 
  2. In your web browser, in the upper right, click the Pega icon to generate your QR code. 
  3. Open Pega Mobile Preview and scan the QR code to preview your app.
    Note: You can further check your work by opening the app and confirming that the preview on the device matches the preview in the channel.

This Challenge is to practice what you learned in the following Module:

Available in the following mission:

If you are having problems with your training, please review the Pega Academy Support FAQs.

Did you find this content helpful?

50% found this content useful

Want to help us improve this content?

We'd prefer it if you saw us at our best.

Pega Academy has detected you are using a browser which may prevent you from experiencing the site as intended. To improve your experience, please update your browser.

Close Deprecation Notice