Getting Started

The user interface of the mobile clients (Android, iOS, and Windows) can be customized using custom XAML definitions. The customization workflow is similar to the XAML customization process used by the Desktop (WinX) client.

Basics

Predefined XAML templates are available and can be overridden as needed. If no customization is provided, the default templates are used.

Default Templates

All customizable default XAML templates can be extracted from the Mobile Windows client via Settings → "Unpack Default XAMLs".

Overriding Default Templates

On Desktop (WinX/UWP), custom XAML files can be added directly to:

[App Package Folder]/LocalState/xaml/

On all supported platforms (including Android and iOS), templates, styles, images, and other resources can also be imported via "Import Customizing" in the app settings. Resources can be imported individually or packaged in a ZIP archive.

Changes are applied immediately and become visible throughout the UI without restarting the application, except on the currently active page. On Mobile Windows, the "Reload Customizing" button can be used to reload customization resources after manual changes.

Differences from Desktop (WinX/UWP)

• Mobile clients use a different XAML dialect and therefore cannot directly consume WinX/UWP customizations.
• Namespace declarations must include the corresponding assembly names.
• Template files use the .xamlx extension instead of .xaml.
• Only resources that need to be customized must be deployed. (This behavior is also supported by newer WinX/UWP versions.)

Tip

For maintainability, deploy only the resources you intend to override.

For example, if you only customize UBIKChildArea, do not deploy unrelated resources such as UBIKMenuArea. Likewise, if you only customize UBIKChildItem, only that resource should be included in your UBIKThemes.

UI Customization

Customize the appearance and behavior of mobile applications

Topics

• Custom Templates
• Resource Dictionaries
• Bindings in Resources
• Images
• Icons
• Converters

Feature Cookbook

Solutions for common customization scenarios.

Topics

• Menu Button Visibility
• Content Filtering
• Mobile Search
• DisplayViewCommand
• Flashlight Integration

Performance

Recommendations and best practices for improving application performance.

Topics

• General Performance Tips
• Layout Optimization
• Labels
• Images
• Layout Compression
• SfListViewExt
• Lazy Loading

Troubleshooting

Known issues and their solutions.

Topics

• HeadlessLayout Style Issues
• DataTrigger Problems
• Incorrect Glyphs
• Gesture Recognizers
• Document Viewer Reloading
• SfPullToRefresh Issues

Migration from UBIK 4

If you're still with a UBIK version below 5, this is your place to start

Topics

• XAML Changes
• Styles and Resources
• Adaptivity
• Layout Changes
• File Structure
• Dark Theme
• Increased Font Sizes