Best practices overview
Review the following table to select the right UI for your application.
Recommendation 8.5 8.6 8.7 New applications Use Theme Cosmos Use Theme Cosmos Evaluate Cosmos React Existing applications No UI changes No UI changes No UI changes Integrations with websites (no professional front-end
developer help) Use mashup Use mashup Evaluate web embeds in Cosmos React Integrations with websites (with professional front-end
developer help) Evaluate starter packs or DX API directly Evaluate SDKs or DX API directly Evaluate SDKs
Guidelines for new applications
- For new applications that you build from scratch, review the feature limitations
in Cosmos React. If your application requires features that
Cosmos React does not support, use Theme Cosmos.
For more information, see Feature limitations in Cosmos React.
- For new applications that you build on top of existing applications that do not use Theme Cosmos, keep the original UI. For example, Pega Customer Service uses Theme UI-Kit. If you build a new application that is based on the Pega Customer Service application, it must also use Theme UI-Kit.
Guidelines for existing applications
- Keep existing applications built with section rules and Theme UI-Kit on their current UI.
- Keep existing Theme Cosmos applications that use a section-based
UI on their current UI. Consider upgrading to the latest version of the Cosmos
theme ruleset (Theme-Cosmos) in the application definition.
For more information, see Updating Theme Cosmos in your application.
- To shorten future migrations, consider preparing for migration now by checking existing applications for compliance with the App Studio delivery approach. Use the App Studio Compliance landing page to identify non-compliant UI elements in your application, and then plan development time to address identified issues.