Skip to main content

         This documentation site is for previous versions. Visit our new documentation site for current releases.      

UI architecture recommendations for mobile apps

Updated on April 27, 2022

In Pega Platform version 8.7, the recommended UI architecture for mobile apps is Theme Cosmos. Learn more about all available architecture options and their use cases.

There are three available UI architectures for mobile apps in Pega Platform version 8.7:

Theme Cosmos
Based on a front-end UI library, the section-based Theme Cosmos architecture helps you build apps by relying on ready-to-use templates, patterns, and themes, which you can also customize to fit your business requirements. Thanks to their prescriptive nature, Theme Cosmos apps require less effort to use and maintain, while also supporting a wide variety of mobile features. The interface of Theme Cosmos apps relies on web components.

For more information, see Theme Cosmos.

Cosmos React
An evolving framework that uses the latest open-source technologies and UI solutions. Cosmos React apps rely on native Android and iOS components to create a new run-time interface.

For more information, see Cosmos React.

Theme UI-Kit
A legacy architecture that is no longer actively developed. Theme UI-Kit consists of a sample end-user UI in the form of design resources, such as rules and skins.

Recommendations for new mobile apps

To make the most of Pega Mobile features and build an app with full Pega Platform functionality, choose Theme Cosmos as the UI architecture for your new app. Theme Cosmos apps offer a variety of mobile features, including offline mode, and ensure high performance and a great experience for users.

If you plan to create an app for simple case management use cases, you can also base your app on the Cosmos React architecture. Cosmos React apps support features, such as case creation, case actions, assignments, the worklist, Pulse comments, and push notifications.

Important: Cosmos React apps in Pega Platform 8.7 do not support the following features:
  • offline mode
  • localization
  • signature control
  • barcode scanning
  • custom modules
  • selected top-level mobile pages (Documents, Spaces, Notifications)

As a best practice, do not use Theme UI-Kit to create new apps.

Recommendations for existing mobile apps that use Theme UI-Kit

For optimal performance results and an improved user experience, move your app from Theme UI-Kit to Theme Cosmos. By moving your app to this more prescriptive environment, you ensure that your app requires less effort to use and maintain. Using Theme Cosmos, you can recreate your current Theme UI-Kit settings in a customizable and better-performing mobile environment that supports many mobile features, including offline mode and localization.

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best. is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us