Creating and changing theme projects

You can create your new theme project using the selected layout type as your starting point. You can change from one layout type to another at any time, however, if you customize the Home screen, the customizations do not apply in the new theme layout. Other changes that you make in the theme project apply.

You must create your theme project for the specific screen dimensions of a BlackBerry device. The BlackBerry Theme Builder scales the screen elements to fit the specified screen dimensions.

When you export a theme, you choose the specific device to export the theme for. You cannot create a theme and export it for use on BlackBerry devices that have different screen dimensions.

For example, if you design a theme for a BlackBerry Torch 9810 smartphone (with screen dimensions of 360 x 480 pixels), users cannot download that theme to a BlackBerry Bold 9900 smartphone (with screen dimensions of 640 x 480 pixels). Users can, however, download the theme to a BlackBerry Bold 9700 smartphone, that has the same screen dimensions (480 x 360 pixels) as the BlackBerry Curve 9530 smartphone.

You can save a theme project at any time and reopen it later to continue designing your theme.

Create a new theme

  1. On the File menu, click New.
  2. In the Create New Theme dialog box, in the Name field, type a name for your new theme project.
  3. In the BlackBerry drop-down list, click the BlackBerry device that you are creating the theme for. For example, if you are creating a theme for the BlackBerry Bold 9900 smartphone, click Bold 9900 Series.
  4. In the Layout Type drop-down list, click the layout that you want to use as the basis for your new theme.
  5. Click Create.

Update a project created with an earlier version of Theme Builder

Themes that were created with earlier versions of BlackBerry Theme Builder are not compatible with later versions of the BlackBerry Device Software. You can update the theme project by opening it in the BlackBerry Theme Builder and then exporting it to the desired version of the BlackBerry Device Software.

  1. On the File menu, click Open.
  2. Navigate to the theme project that you want to update.
  3. Click Open. The BlackBerry Theme Builder prompts you to update the theme file to a newer version.
  4. Click OK.

Changing theme layouts and screen sizes

When you create a theme, you must select the layout and the BlackBerry device model that you want to target. However, if you wish to create a family of related themes that, for example, targets different screen sizes and present different Home screen layouts, the BlackBerry Theme Builder enables you to do so without you having to create similar looking themes from scratch.

You can change from one theme type to another at any time. Changes you made to the Home screen are lost, since they will no longer apply in the new theme. However, the BlackBerry Theme Builder preserves changes elsewhere in the theme.

A single theme project cannot target multiple screen sizes. You must create a new theme to target a different screen size. However, you can leverage design work you’ve already done for another theme by importing it into your new theme.

When you import a theme that targets a different screen size, all modified theme elements are imported into your new theme. After the theme is imported, you may need to make some slight adjustments, for example, in the placement of banner elements, to achieve the desired results.

Change the layout type

  1. On the Edit menu, click Change Layout Type.
  2. Select the layout type that you want to use.

Convert a theme to a different screen size

You should choose the same theme layout as the one that you plan to convert, or the customizations to the Home screen are not converted.

  1. On the File menu, click New.
  2. In the Create New Theme dialog box, complete the fields and select a screen size.
  3. Click Create.
  4. When the new project is created, click File > Import.
  5. Navigate to the theme that you want to convert to the new screen size.