iOS - UI Customization¶
The EnQualify SDK interface can be dynamically customized via the Backoffice. Visual parameters such as color, font, icon, and text are managed from the Backoffice panel without the need for code changes; the SDK automatically retrieves the current settings each time it is launched.
UI customization parameters are automatically obtained by the SDK at the settingGetCompleted step. No code integration is required.
Customizable Areas¶
Colors¶
| Parameter | Description | Example |
|---|---|---|
primaryColor | Primary color — buttons, highlights, progress bar | #1A56DB |
secondaryColor | Secondary color — titles, icons | #0E3F9E |
backgroundColor | Screen background color | #FFFFFF |
textColor | General text color | #111928 |
errorColor | Error state color | #E02424 |
successColor | Success state color | #057A55 |
overlayColor | Camera overlay color and opacity | #000000 + %60 |
Typography¶
| Parameter | Description |
|---|---|
fontFamily | Font family to be used in all SDK screens |
titleFontSize | Title font size |
bodyFontSize | Body text font size |
buttonFontSize | Button text font size |
If a custom font is to be used, the relevant font files must be added to the application and defined in the Info.plist. Otherwise, the SDK will revert to the system font.
Buttons and Shapes¶
| Parameter | Description |
|---|---|
buttonCornerRadius | Button corner roundness (pt) |
buttonBorderWidth | Button border thickness (pt) |
buttonBorderColor | Button border color |
cardCornerRadius | Corner roundness of card components |
Icons and Images¶
| Parameter | Description |
|---|---|
logoUrl | Application logo URL — displayed on waiting and completion screens |
successIconUrl | Success screen icon |
errorIconUrl | Error screen icon |
loadingAnimationUrl | Loading animation (in Lottie JSON format) |
Texts and Translation¶
All texts on the SDK screens can be customized via the Backoffice. This allows for support for different languages without code changes.
| Parameter | Description |
|---|---|
strings | Screen-based text definitions — in key-value format |
locale | Default language code (e.g. "TR", "EN") |
The locale value can also be set with the locale parameter in the BaseModel. If both are defined, the value in BaseModel takes precedence.
Screen-Based Customization¶
Each SDK screen can be independently configured in the Backoffice. The main customizable screens are:
| Screen | Customizable Items |
|---|---|
| Welcome screen | Logo, title, description text, button color |
| Identity scanning screen | Overlay color, guiding texts, frame color |
| Hologram control screen | Guiding texts, animation |
| Liveness screen | Frame color, motion guiding texts |
| NFC reading screen | Guiding texts, icon |
| Waiting screen (VideoCall) | Logo, waiting text, animation |
| Meeting screen | Button icons, PiP size |
| Completion screen | Success/error icon, message text, button label |
Voice Guidance Customization¶
Voice guidance in SDK screens can be changed via the Backoffice. If you want to use a custom audio file, there are two methods available:
Via Backoffice: Audio files are uploaded from the Backoffice panel, and the SDK downloads the updated files at each launch.
Via application bundle: If you want to embed audio files into the application, it is sufficient to add them to the bundle using file names recognized by the SDK. For details, refer to Core Module → Audio File Management.
Customization Priority Order¶
If the same parameter is defined in multiple places, the SDK follows this priority order: