Customization through XML

The VIDA SDK exposes a set of UI attribute keys through its attr.xml resource file. By redefining these keys in your application's theme, your values take effect at runtime across the SDK's screens - no code changes required.

You can customize:

• Primary and secondary call-to-action (CTA) colors

• Tutorial screen - colors and text

• Permission screen - colors and text

• Camera preview screen - colors and text

• Review screen - colors and text

How to apply customizations

1. Open your styles.xml or themes.xml file in your Android project.

2. Inside your theme, redefine the keys you want to override with your own values.

Example - changing the primary CTA background color:

<resources xmlns: tools="http://schemas.android.com/tools">
   <style name="VIDALivenessTheme" parent="VIDA.Liveness.Theme.Default">
           <item name="vida_primary_cta_background_color">@color/red_pilati_ff3232</item>
   </style>
</resources>

Your theme must extend VIDA.Liveness.Theme.Default. Only the keys you redefine change; everything else falls back to the SDK defaults.

Font customization (applies to every screen)

Every text element on every screen supports a matching font family and font size key. You don't need to look these up one by one — derive them from the text key:

To customize	Append to the text key	Format
Font family	_font_family	string
Font size	_font_size	dimension

For example, the tutorial title (vida_tutorial_screen_title_text) becomes:

<attr name="vida_tutorial_screen_title_text_font_family" format="string"/>
<attr name="vida_tutorial_screen_title_text_font_size" format="dimension"/>

The tables below therefore list colors and text only - the font keys follow this pattern.

Tutorial Screen

Adjust the look and feel of the initial tutorial screen - background, text, transaction ID display, and the "remove wearables" guidance.

Colors

Element	Attribute key
Background	vida_tutorial_screen_background_color
Title text	vida_tutorial_screen_title_text_color
Transaction ID background	vida_tutorial_screen_transaction_ID_background_color
Transaction ID text	vida_tutorial_screen_transaction_ID_text_color
Instruction text	vida_tutorial_screen_instruction_text_color
Warning text	vida_tutorial_screen_warning_text_color
Wearable text	vida_tutorial_screen_wearable_text_color

All keys use format="color" .

Text

Element	Attribute key
Title	vida_tutorial_screen_title_text
Transaction ID	vida_tutorial_screen_transaction_id_text
Instruction	vida_tutorial_screen_instruction_text
Warning	vida_tutorial_screen_warning_text
Wearing glasses message	vida_tutorial_screen_wearing_glass_text
Wearing hat message	vida_tutorial_screen_wearing_hat_text
Wearing scarf message	vida_tutorial_screen_wearing_scarf_text
Wearing mask message	vida_tutorial_screen_wearing_mask_text
Primary CTA	vida_tutorial_screen_primary_cta_text

All keys use format="string" . Add _font_family / _font_size for font control.

Camera Permission Screen

Customize the screen that requests camera access.

By default the camera permission screen appears on top of the tutorial screen. Its background color can still be customized even when the tutorial screen is disabled via setShowTutorialScreen(false) .

By default the camera permission screen will be shown on top of the tutorial screen.

Colors

Element	Attribute key
Background	vida_permission_screen_background_color
Title text	vida_permission_screen_title_text_color
Description text	vida_permission_screen_description_text_color

All keys use format="color".

Text

Element	Attribute key
Title	vida_permission_screen_title_text
Description	vida_permission_screen_description_text
Primary CTA	vida_permission_screen_primary_cta_text
Secondary CTA	vida_permission_screen_secondary_cta_text

All keys use format="string" . Add _font_family / _font_size for font control.

Camera Preview Screen

Customize the camera capture screen - background, overlay, and the instruction messages shown while the user positions their face.

Colors

Element	Attribute key
Background	vida_camera_screen_background_color
Instruction text	vida_camera_screen_instruction_text_color
Overlay background	vida_camera_screen_overlay_background_color
Stroke	vida_camera_screen_stroke_color
Animation stroke	vida_camera_screen_animation_stroke_color

All keys use format="color" .

Instruction Text

Attribute Key	Bahasa String	English String
vida_camera_screen_instructions_text_no_face	Tempatkan wajah Anda dalam bingkai	Put your face in the frame
vida_camera_screen_instructions_text_frame_your_face_out_of_box	Tempatkan wajah Anda dalam bingkai	Tempatkan wajah Anda dalam bingkai
vida_camera_screen_instructions_text_face_detected	-	-
vida_camera_screen_instructions_text_face_too_far	Mendekat	Move closer
vida_camera_screen_instructions_text_face_too_close	Mundur	Move Back
vida_camera_screen_instructions_text_face_not_straight	Hadapkan wajah ke layar	Face the screen directly
vida_camera_screen_instructions_text__multiple_face_detected	Pastikan hanya satu wajah di layar	Keep one face in the frame
vida_camera_screen_instructions_text_eye_closed	Buka mata Anda	Open your eyes
vida_camera_screen_instructions_text_left_eye_closed	Buka mata Anda	Open your eyes
vida_camera_screen_instructions_text_right_eye_closed	Buka mata Anda	Open your eyes
vida_camera_screen_instructions_text_image_too_dark	Pindah ke tempat cerah	Move to well-lit area
vida_camera_screen_instructions_text_eye_occlude	Lepaskan kacamata	Remove your glasses

These messages guide the user during capture. All keys use format="string".

Note: Instruction font sizing has two levels: a per-state key (e.g. vida_camera_screen_instructions_text_no_face_font_size) and a general key vida_camera_screen_instructions_text_font_size that applies to all instruction states.

Review Screen

Customize the screen where the user reviews the captured image - including the processing spinner, error text, and guidelines.

Colors

Element	Attribute Key
Background	vida_review_screen_background_color
Title text	vida_review_screen_title_text_color
Instruction text	vida_review_screen_instruction_text_color
Spinner - start	vida_review_screen_spinner_start_color
Spinner - center	vida_review_screen_spinner_center_color
Spinner - end	vida_review_screen_spinner_end_color
Error text	vida_review_screen_error_text_color
Guideline text	vida_review_screen_guideline_text_color
Guideline link	vida_review_screen_guideline_link_color

All keys use format="color".

Text

Element	Attribute Key
Title	vida_review_screen_title_text
Instruction	vida_review_screen_instruction_text
CTA - Submit	vida_review_screen_cta_text_submit
CTA - Retake	vida_review_screen_cta_text_retake
CTA - Try again	vida_review_screen_cta_text_try_again
CTA - Try later	vida_review_screen_cta_text_try_later
Guideline text	vida_review_screen_guideline_text
Guideline message link	vida_review_screen_guideline_message_link

All keys use format="string". Add _font_family / _font_size for font control.

Error message text

You can override the message shown for specific backend error codes. All keys use format="string".

Error Code	Attribute Key
1051	vida_review_screen_backend_error_message_1051
1052	vida_review_screen_backend_error_message_1052

Note: The codes above are examples. Any backend or SDK error code marked YES in the Error Codes reference is customizable using the same vida_review_screen_backend_error_message_<code> pattern.

Global Customization (All Screens)

These keys apply consistently across every screen. All use format="color".

Element	Attribute Key
Primary CTA background	vida_primary_cta_background_color
Primary CTA text	vida_primary_cta_text_color
Secondary CTA background	vida_secondary_cta_background_color
Secondary CTA text	vida_secondary_cta_text_color
Back arrow	vida_back_cta_arrow_color
Spinner - start	vida_spinner_start_color
Spinner - center	vida_spinner_center_color
Spinner - end	vida_spinner_end_color