Add contextual Duck.ai onboarding #7593

joshliebe · 2026-01-27T11:42:32Z

Task/Issue URL: https://app.asana.com/1/137249556945/project/488551667048375/task/1212975986537003?focus=true

Description

Adds an onboarding dialog when opening contextual Duck.ai for the first time.
“Got it” dismisses the dialog and stores that it has been dismissed.
“View settings” navigates to “AI Features” and hides the dialog.

Steps to test this PR

UI changes

Note

Medium Risk
Changes the Duck.ai contextual entry flow by gating it behind a new, persistent onboarding bottom sheet and adds new pixel instrumentation. Risk is mainly UX/behavioral (showing the wrong sheet or persisting dismissal incorrectly) rather than security-related.

Overview
Adds a non-dismissible contextual-mode onboarding bottom sheet that is shown the first time a user opens Duck.ai contextual mode; primary action marks onboarding complete and continues to the contextual sheet, while secondary action opens AI Features settings.

Updates the omnibar Duck.ai click path to branch between ShowDuckAIContextualOnboarding vs ShowDuckAIContextualMode based on a persisted completion flag stored in DuckChat DataStore/repository, and introduces new pixels (m_aichat_contextual_onboarding_*) for display/confirm/settings actions.

Includes new UI resources (layout + icon + localized strings) and expands unit/instrumentation tests to cover the new command, persistence, and repository/API additions.

^{Written by Cursor Bugbot for commit c6f1607. This will update automatically on new commits. Configure here.}

joshliebe · 2026-01-27T11:42:54Z

Add contextual Duck.ai onboarding #7593 : 2 dependent PRs (#7595 , #7597 ) 👈 (View in Graphite)
develop

This stack of pull requests is managed by Graphite. Learn more about stacking.

app/src/main/java/com/duckduckgo/app/browser/BrowserTabFragment.kt

...src/main/java/com/duckduckgo/duckchat/impl/ui/DuckAiContextualOnboardingBottomSheetDialog.kt

app/src/main/res/layout/bottom_sheet_duck_ai_contextual_onboarding.xml

...src/main/java/com/duckduckgo/duckchat/impl/ui/DuckAiContextualOnboardingBottomSheetDialog.kt

…oarding

...n/java/com/duckduckgo/duckchat/impl/ui/DuckAiContextualOnboardingBottomSheetDialogFactory.kt

malmstein

Works as expected. Left a few suggestions but nothing blocker, nice job!

...src/main/java/com/duckduckgo/duckchat/impl/ui/DuckAiContextualOnboardingBottomSheetDialog.kt

...n/java/com/duckduckgo/duckchat/impl/ui/DuckAiContextualOnboardingBottomSheetDialogFactory.kt

duckchat/duckchat-impl/src/main/res/layout/bottom_sheet_duck_ai_contextual_onboarding.xml

...src/main/java/com/duckduckgo/duckchat/impl/ui/DuckAiContextualOnboardingBottomSheetDialog.kt

...at-impl/src/main/java/com/duckduckgo/duckchat/impl/ui/DuckAiContextualOnboardingViewModel.kt

Task/Issue URL: https://app.asana.com/1/137249556945/project/1200204095367872/task/1212787351113601?focus=true ### Description - Translations for #7593 ### Steps to test this PR - [ ] CI is green  --- > [!NOTE] > **Low Risk** > Low risk localization-only change: adds/relocates string resources without altering app logic; primary risk is missing/incorrect translations or resource merge issues. > > **Overview** > Adds localized string resources for the **Duck.ai contextual onboarding** bottom sheet (title/body and primary/secondary actions) across `values/` and multiple `values-xx/` locales. > > Moves these onboarding strings out of `values/donottranslate.xml` into the translatable `strings-duckchat.xml` files (and removes the English copies from `donottranslate.xml`). > > <sup>Written by [Cursor Bugbot](https://cursor.com/dashboard?tab=bugbot) for commit c80e962. This will update automatically on new commits. Configure [here](https://cursor.com/dashboard?tab=bugbot).</sup>  --------- Co-authored-by: Dax The Translator <daxmobile@duckduckgo.com>

cursor

Cursor Bugbot has reviewed your changes and found 1 potential issue.

...at-impl/src/main/java/com/duckduckgo/duckchat/impl/ui/DuckAiContextualOnboardingViewModel.kt

Task/Issue URL: https://app.asana.com/1/137249556945/task/1212889618211014?focus=true ### Description - Pixels for contextual Duck.ai onboarding. ### Steps to test this PR - [x] Fresh install - [x] Enable “contextualMode” in Feature Flag Inventory - [x] Visit a website - [x] Tap the Duck.ai omnibar icon - [x] Verify that “m_aichat_contextual_onboarding_displayed” is sent - [x] Tap “Got it" - [x] Verify that “m_aichat_contextual_onboarding_confirm_pressed” is sent - [x] Repeat and tap “View settings" - [x] Verify that “m_aichat_contextual_onboarding_settings_pressed” is sent  --- > [!NOTE] > **Low Risk** > Low risk: adds new analytics pixel definitions and fires them from the onboarding bottom sheet without changing core Duck.ai behavior or data handling. > > **Overview** > Adds three new Duck.ai contextual onboarding pixels (sheet shown, "Got it" pressed, and "View settings" pressed) to `duck_chat.json5` and wires them into `DuckChatPixelName`/param-removal configuration. > > Updates `DuckAiContextualOnboardingBottomSheetDialog` (and its factory) to inject `Pixel` and fire the new events when the sheet is displayed and when either action is taken. > > <sup>Written by [Cursor Bugbot](https://cursor.com/dashboard?tab=bugbot) for commit 9353974. This will update automatically on new commits. Configure [here](https://cursor.com/dashboard?tab=bugbot).</sup>