Customization guide

The Gini Vision Library components can be customized either through the GiniConfiguration, the Localizable.string file or through the assets. Here you can find a complete guide with the reference to every customizable item.

Customizable assets can be found in the Assets repo.

Supporting dark mode

Some background and text colors use the GiniColor type with which you can set colors for dark and light modes. Please make sure to set contrasting images to the background colors in your .xcassets for the Gini Vision Library images you override (e.g. onboardingPage1). The text colors should also be set in contrast to the background colors.

Generic components

GiniConfiguration.backgroundColor is deprecated in version 5.5.0. Use the screen specific background color instead e.g. GiniConfiguration.onboardingScreenBackgroundColor.

1. Navigation bar

2. Notice

2. GVL font

Camera screen



1. Navigation bar
  • Title → ginivision.navigationbar.camera.title localized string
  • Close button
  • Help button
    • Image → navigationCameraHelp image asset
    • Title → ginivision.navigationbar.camera.help localized string
2. Camera preview
3. Camera buttons container
4. QR code popup



Review screen



1. Navigation bar
  • Title → ginivision.navigationbar.review.title localized string
  • Back button
  • Next button
    • Image → navigationReviewContinue image asset
    • Title → ginivision.navigationbar.review.continue localized string
2. Review top view
  • Title → ginivision.review.top localized string
3. Review bottom view

Multipage Review screen



1. Navigation bar
  • Back button
  • Next button
    • Image → navigationReviewContinue image asset
    • Title → ginivision.navigationbar.review.continue localized string
2. Main collection
3. Page item
4. Bottom container

Analysis screen



1. Navigation bar
2. PDF Information view
3. Loading view

Supported formats screen



1. Supported format cells

Open with tutorial screen



1. Header
  • Text → ginivision.help.openWithTutorial.collectionHeader localized string
2. Open with steps
  • App name → GiniConfiguration.openWithAppNameForTexts
  • Step indicator color → GiniConfiguration.stepIndicatorColor
  • Step 1
    • Title → ginivision.help.openWithTutorial.step1.title localized string
    • Subtitle → ginivision.help.openWithTutorial.step1.subtitle localized string
    • Image → openWithTutorialStep1 (German) and openWithTutorialStep1_en (English) image assets
  • Step 2
    • Title → ginivision.help.openWithTutorial.step2.title localized string
    • Subtitle → ginivision.help.openWithTutorial.step2.subtitle localized string
    • Image → openWithTutorialStep2 (German) and openWithTutorialStep2_en (English) image assets
  • Step 3
    • Title → ginivision.help.openWithTutorial.step3.title localized string
    • Subtitle → ginivision.help.openWithTutorial.step3.subtitle localized string
    • Image → openWithTutorialStep3 (German) and openWithTutorialStep3_en (English) image assets

Capturing tips screen



1. Capturing tip images
  • Tip 1 image → captureSuggestion1 image asset
  • Tip 2 image → captureSuggestion2 image asset
  • Tip 3 image → captureSuggestion3 image asset
  • Tip 4 image → captureSuggestion4 image asset
  • Tip 5 image → captureSuggestion5 image asset
2. Go to camera button



1. Selected image

Onboarding screens



1. Background
2. Image
  • Page image → onboardingPage* image asset
3. Text
4. Page indicator
5. Current page indicator

Help screen



1. Navigation bar
2. Table View Cells
3. Background