Preparing custom branding assets

You upload branding assets to Pega Platform as a single ZIP file. While the contents of this file can differ, depending on your version of Pega Platform, it contains the image files for icons that are displayed on the home screen of the mobile device, and as splash screens when the app starts.

You can generate a full set of branding graphics for a native app automatically at the app building stage. If needed, you can choose to display specific images on selected displays. In the latter case, to create detailed icons with text visible on Retina devices only, you can create such files manually in PNG format, according to the following guidelines:
  • For Android, see the icon design section of the Material Design guidelines published by Google.
  • For iOS, see the graphics section of the iOS Human Interface Guidelines published by Apple.
Note: To avoid issues with newer devices, download the most recent version of the assets package from Pega Community, when you are updating an existing mobile app.
If you want to generate the branding graphics automatically, for a detailed description of the assets.zip directory structure, see Contents of the branding assets package. If you want to provide a complete set of branding graphics, a sample file includes a full set of branding graphics that you can replace with your custom resources. Take the following into consideration:
  • When you add custom images, make sure that the directory structure, file names, and image dimensions are identical to those in the default .zip file.
  • When a specific asset is missing from the .zip file, the device's operating system rescales the existing assets (Android) or replaces the missing assets with system-default resources (iOS).
  • If you encounter warnings, which indicate that you might have used an incorrect version of the .zip file, see Branding assets templates for various Pega Mobile Client versions on the Pega Community for guidelines on how to select the best template.
  1. If you want to generate the branding graphics automatically:
    1. Right-click the branding-assets.zip file and save the file in a directory of your choice.
    2. If you are building a mobile app for iOS, skip to substep g.
    3. Create custom splashlogo.png files in different resolution versions and place them in their respective folders of the branding-assets.zip file.
    4. Create the following files and place them within the android directory of the branding-assets.zip file.
      • notification_icon.svg
      • keepalive_icon.svg
      • icon_round.svg
    5. Create the icon.svg file and place it in the common_assets directory of the branding-assets.zip file.
      The SVG files are processed automatically.
    6. If you are building a mobile app for Android, this concludes the procedure.
    7. Create the icon.svg file and place it in the common_assets directory of the branding-assets.zip file.
    8. Create the splashlogo.png file and place it in the ios directory of the branding-assets.zip file.
    9. Optional: For better rescaling results, you can provide the splash screen file in high resolution with either the @2x or the @3x suffix.
  2. If you want to provide a complete set of branding graphics:
    1. Right-click the branding-assets-advanced.zip file.
    2. Save the file in a directory of your choice.
    3. Replace all the graphics in the file with your custom resources.