Gemini UI Layer

Last updated: May 2026

This directory contains the user interface (UI) components for the Gemini (BWG) onboarding and First Run Experience (FRE) flows on Chrome for iOS.

Following iOS UI development guidelines and branded asset requirements, the controllers are designed for elegant sheet presentation, micro-animations, responsive dynamic layouts, and full localization (including South Korea compliance overrides).

Onboarding (FRE) Presentation Flow

Depending on the kGeminiFRERefactor feature flag, GeminiFirstRunCoordinator launches either the new step-based page container or the legacy wrapper:

When kGeminiFRERefactor is Enabled (Refactored Flow)

graph TD
    Container[GeminiFirstRunPageViewController]
    Container -->|Presents Step 0| Promo[GeminiPromoViewController]
    Container -->|Presents Step 1| Consent[GeminiConsentViewController]

When kGeminiFRERefactor is Disabled (Legacy Flow)

graph TD
    Wrapper[GeminiFirstRunWrapperViewController]
    Wrapper -->|Presents Initial Info| Promo[GeminiPromoViewController]
    Wrapper -->|Transitions to Consent/Live| Consent[GeminiConsentViewController]

Component Details

1. UI Wrapper & Orchestrator

• gemini_first_run_page_view_controller.h & gemini_first_run_page_view_controller.mm (Refactored Flow): A generic horizontally-scrolling page container UIViewController utilizing sheets presentation. It paginates an array of onboarding steps (UIViewController<GeminiFirstRunStep>*) and handles adaptive height transitions.
• gemini_first_run_wrapper_view_controller.h & gemini_first_run_wrapper_view_controller.mm (Legacy Flow): A container UIViewController utilizing sheets presentation. It orchestrates transitions between the Promotional intro page (GeminiPromoViewController) and the main Consent/Permissions page (GeminiConsentViewController).
• gemini_first_run_step.h: Defines the GeminiFirstRunStep protocol, step identifiers, and height delegate interface used by the refactored page container.
• gemini_fre_view_controller_protocol.h: Defines standard interface protocols used by the legacy wrapper flow.
• gemini_first_run_mutator.h: Defines mutator protocols for updating states and opening hyperlinks, bridging UI actions to the background mediator layer.

2. Promotional Intro

• gemini_promo_view_controller.h & gemini_promo_view_controller.mm: Renders the initial visual promotion card, welcoming users to the Gemini features and displaying high-level summaries of its capabilities.

3. Consent & Permission UI

• gemini_consent_view_controller.h & gemini_consent_view_controller.mm: Renders the main consent card stack. Features include:
  • Adaptation for enterprise-managed accounts.
  • South Korea compliance localized overrides (substituting custom terms and privacy notices).
  • Permissions interface for Gemini Live (initiating microphone authorizations).
  • Custom hyperlink interactions via UITextViewDelegate to safely open privacy links in new tabs without launching context menus.

4. Helpers & Utilities

• gemini_ui_utils.h & gemini_ui_utils.mm: Internal utilities for layout math, safe areas, and visual component rendering.
• resources/: Contains brand-compliant assets, custom logos, and color definitions used across Gemini screens.

Testing

• Unit Tests:
  • gemini_promo_view_controller_unittest.mm
  • gemini_consent_view_controller_unittest.mm
  • gemini_first_run_page_view_controller_unittest.mm
  • gemini_fre_wrapper_view_controller_unittest.mm
  • gemini_ui_utils_unittest.mm
• Integration Tests (EarlGrey 2):
  • gemini_egtest.mm: Comprehensive EarlGrey integration test suite executing end-to-end simulator checks of the promotional screens, Korean localizations, managed accounts, and consent mutation pipelines.