Update onboarding to new design and flow
See original GitHub issueDescription
Update the onboarding UI/UE to the new design and flow.
- First run dialog for Windows/macOS/Linux will be hidden/disabled https://github.com/brave/brave-browser/issues/27225
- brave://welcome will be shown as the first screen on first launch (after successful installation)
- brave://welcome will give users the ability to Set Brave as Default or skip to next screen
- Second screen will give users the ability import from the browsers installed on their machine: Chrome, Chrome Beta, Chrome Canary, Edge, Internet Explorer, Firefox, Opera, and Vivaldi. The default browser will be default selected.
- If there is more than one user profile in Chromium based browsers, we will show an additional selection screen to allow which profiles to import. Multiple selection and import of all profiles are supported.
- If there are no browsers to import with the main use case being Safari import, then users will fallback to selecting theme color https://github.com/brave/brave-browser/issues/27170
- There will be a confirmation screen after import.
- The final screen will show
Help Improve Bravescreen. https://github.com/brave/brave-browser/issues/27126 - After completing the onboarding, users will be taken to the New tab page.
Actual result:
Expected result:
Reproduces how often:
Brave version (brave://version info)
Version/Channel Information:
- Can you reproduce this issue with the current release? n/a
- Can you reproduce this issue with the beta channel? yes
- Can you reproduce this issue with the nightly channel? yes
Other Additional Information:
- Does the issue resolve itself when disabling Brave Shields? n/a
- Does the issue resolve itself when disabling Brave Rewards? n/a
- Is the issue reproducible on the latest version of Chrome? n/a
Miscellaneous Information:
Related issues: https://github.com/brave/brave-core/pull/16208 https://github.com/brave/brave-browser/issues/27126 https://github.com/brave/brave-browser/issues/27253
https://github.com/brave/brave-core/pull/16164 https://github.com/brave/brave-browser/issues/26851 https://github.com/brave/brave-browser/issues/27060 https://github.com/brave/brave-browser/issues/27061 https://github.com/brave/brave-browser/issues/27105
Issue Analytics
- State:
- Created a year ago
- Comments:7 (3 by maintainers)
Top Results From Across the Web
New Feature Onboarding - how to get users hooked on every ...
To start with your new feature onboarding flow, you need to first go to UserGuiding Panel and the Guides page. There, you can...
Read more >First Impressions - a Guide to Onboarding UX - Toptal
An onboarding experience is a way to introduce users to a new product, app, or feature. Onboarding UX is the design of a...
Read more >Your Guide To Onboarding Flows: Complete With Examples ...
We take you through what onboarding flows are, how to succeed with them, and provide inspiration from top SaaS companies.
Read more >13 Best Onboarding Flow Examples for New Users (2023)
We look at the 10 of the best onboarding experience examples, and how to decrease time-to-value for new users with effective onboarding ......
Read more >User Onboarding Examples: Analyzing 6 Real-Life ... - CXL
User onboarding flows are key to retention, yet aren't given continuous attention. Here are 6 user onboarding flows and what you can learn...
Read more >
Top Related Medium Post
No results found
Top Related StackOverflow Question
No results found
Troubleshoot Live Code
Lightrun enables developers to add logs, metrics and snapshots to live code - no restarts or redeploys required.
Start Free
Top Related Reddit Thread
Top Related Hackernoon Post
No results found
Top Related Tweet
No results found
Top Related Dev.to Post
No results found
Top Related Hashnode Post
No results found

Removing
QA/Blockedas required uplifts (https://github.com/brave/brave-core/pull/16321) to 1.47.x were doneVerification
In progressusingand
Test Case 1: New onboarding UI -
brave://welcomepage upon Brave launch -PASSEDFirst run dialogno longer displayedSet Brave as default browserConfirmed new onboarding UI is shown -
brave://welcomepage withSet Brave as a default browserandSkipbuttons as the first screenTest Case 2: Single browser and Single profile
Case 1: Second screen
Import Settingswill give users the ability to import and most recent used browser is set as a default -Edge-FailedMicrosoft Edgewith a single profile withbookmarks,extensions,saved passwordsbrave://welcomepage -Set Brave as default browserMicrosoft Edge####Confirmed
Import Settings, displayed after setting Brave as default *Chromium based browser was checked by default on Import Settings page - Failed *Most recent used browser was Edge, and it was not checked by default - FailedFiled: *https://github.com/brave/brave-browser/issues/27522
Case 2 Set
Braveas default and complete import fromMicrosoft Edge-PASSEDbrave://welcomepage -import settingsscreenMicrosoft EdgeImportbuttonSetup completescreen is displayedHelp improve Bravescreen is displayedBrave is your default browsermessage is shownCase 3: Verify default settings in the
Help improve brave betterscreen -PASSEDHelp improve Brave betterscreen is displayedSend diagnostic reports if you experience a crash or freezeentry is checked as defaultShare completely private and anonymous product insights about what features are being used by Brave's usersentry is checked as defaultbrave://settings/privacylink beneath theFinishbuttonbrave://settings/privacytab opened in a separate tabAutomatically send diagnostic reportssetting is enabledAllow privacy-preserving product analytics (P3A)setting is enabledPrivacy Policylinkbrave://settings/privacyHelp improve Brave better screen and clickLearn more` linksSend diagnostic reports if you experience a crash or freezeredirected to:Share completely private and anonymous product insights about what features are being used by Brave's usersredirected to:Confirmed links on the page worked as expected
Case 4: Verify
Bookmarks,Extensions&Saved passwordsare successfully imported fromEdge-FAILEDHelp improve Bravescreen is displayedFinishbuttonbrave://bookmarkssaved passwordsshown inbrave://settings/passwordshistoryshown inbrave://history####Confirmed Bookmarks imported successfully ####Confirmed Saved passwords imported successfully ****Extensions are not imported - *https://github.com/brave/brave-browser/issues/27487
Case 5: Uncheck default settings in the
Help improve brave betterscreen -PASSEDSet Brave as default browserMicrosoft EdgeImportbuttonSetup completepage shownSend diagnostic reports if you experience a crash or freezeentryShare completely private and anonymous product insights about what features are being used by Brave's usersentryFinishbrave://settings/privacyin a new tab page####Confirmed
Automatically send diagnostic reportssetting is disabled ####ConfirmedAllow privacy-preserving product analytics (P3A)setting is disabledCase 6: Do not set Brave as default & do not import -
PASSEDSkiponbrave://welcomescreenSkiponImport Settingsscreenbrave://settings/getStarted####Confirmed no profile data is imported. ####Confirmed
Brave://settings/getStartedpage shownMake defaultbuttonFiled: *https://github.com/brave/brave-browser/issues/27554
Case 7: Set Brave as default but do not import -
PASSEDSet Brave as default browseronbrave://welcomescreenSkiponImport Settingsscreenbrave://settings/getStartedConfirmed
Brave is your default browsermessage shownCase 8: Do not set Brave as default but import Profile data -
PASSEDSkiponbrave://welcomescreenImportonImport SettingsscreenMicrosoft EdgeMicrosoft Edge Profile 2Finishbrave://settings/getStartedConfirmed new tab page shown with Profile data is imported (Bookmarks, Save passwords)
*
Brave://settings/getStartedpage should showMake defaultbutton instead page showsBrave is your default browsermessage.Case 9: Set Brave as default and skip import from onboarding UI, but proceed to import from
brave://settings/importData-FailedPrerequisite: Make sure Microsoft Edge as a default browser in `Windows
Set Brave as default browserSkipFinishnew tabpage opened as expectedBrave is your default browsermessage shownbrave://settings/importDataMicrosoft EdgeProfile 1Import####Confirmed bookmarks are imported and shown in the
Bookmarksside panel *Extensions are not imported - *https://github.com/brave/brave-browser/issues/27487 *ClickImportbutton onImport bookmarks and settingsmodal failed to dismiss- *https://github.com/brave/brave-browser/issues/27425Test Case 3: Single browser & Multiple profiles
Case 1: Set Brave as default and import from multiple profiles -
Microsoft Edge-PASSEDPre-requisite: Created 4 Profiles in Microsoft Edge with following:
Set Brave as default browserMicrosoft EdgeImportSelect profile to importmodalSelect Allto selectProfile 3BackImport SettingsscreenImportagainImport profilesSetup Completeconfirmation screen shownFinish####Confirmed
Bookmarksfrom Profile 1 and 2 are successfully imported ####ConfirmedSaved passwordsfrom Profile 1 are successfully importedTest Case 4: Multiple browsers and Multiple profiles
Case 1: Verify all installed non-Brave browsers are shown in the
Import Settingspage -FAILEDPre-requisites: Have import supported browsers installed
Chrome,Chrome Beta,Chrome Dev,Chrome Canary,Edge,Firefox,Opera, andVivaldiSet Brave as default browserbutton onbrave://welcomepageConfirmed
Chrome,Chrome Canary,Edge,Firefox,Opera, andVivaldibrowsers listed*
Chrome BetaandChrome Devare not listedFiled *https://github.com/brave/brave-browser/issues/27500
Case 2: Do not show all
Chrome channelsin theSelect profile to importscreen when Chrome(Stable)selected inImport Settingspage -FAILEDSet Brave as default browserbutton onbrave://welcomepageChromeImport*Profiles from Chrome Beta and Dev channels also rendered. Should list only
Chromestable channel - Chrome Beta Person 1 - Chrome Dev Person 1 - Chrome Dev Person 2Case 3: Set Brave as default and import from multiple browsers with multiple profiles - Select individually -
PASSEDFirefox
Create 4 Firefox profiles: Profile 1: Bookmarks, Extensions, Saved passwords Profile 2: Bookmarks, Extensions Profile 3: Bookmarks Profile 4: No data
Set Brave as default browserbutton onbrave://welcomepageMozilla FirefoxonImport SettingsscreenImportSelect AllImport profilesFinishChrome Stable -
PASSEDProfile 1: Bookmarks, Saved passwords, Extensions Profile 2: Bookmarks Profile 3: No Data Profile 4: Bookmarks Profile 5: Bookmarks
Set Brave as default browserChromeImportSelect Alland unselectChrome Person 2Import profilesFinish####Confirmed Bookmarks, saved passwords are successfully imported from Profile 1 ####Confirmed Bookmarks from Profiles 4 & 5 are imported ####Confirmed Profile 2 data is unchecked, so no data is imported
Case 4: Set Brave as default and import from multiple browsers with multiple profiles simultaneously -
FAILEDChrome Canary Profile 1: Bookmarks & Saved passwords Profile 2: Bookmarks
Set Brave as default browser*Could not select multiple browsers simultaneously
Chrome Beta -
Failed- not listedProfile 1: Extensions & Saved passwords
Chrome Betachannel is not listedChrome Dev -
FailedProfile 1: Bookmarks, Saved passwords, Extensions Profile 2: Bookmarks
Vivaldi
Create 3 Vivaldi profiles Profile 1: Bookmarks, Extensions, Saved passwords Profile 2: Bookmarks Profile 3: No data
Filed: *https://github.com/brave/brave-browser/issues/27500
Test Case 5: Upgrade
Case 1: Previously onboarding is completed -
PASSED1.46.144Skip welcome tourlinkConfirmed new onboarding UI is not displayed.
Case 2: If previously onboarding is not completed, new onboarding UI is shown -
PASSED1.46.144Skip welcome tourlink and close BraveConfirmed new onboarding UI is displayed.
Test Case 6: Background animations only work if hardware acceleration is enabled and “Reduce motion” flag disabled
Case 1: Disable HW accel --disable-gpu -
PASSEDnew profile launch Brave with Disable HW accel flag
--disable-gpuConfirmed no animation played upon Brave launch on
brave://welcome- first screendisable
https://user-images.githubusercontent.com/98358127/209826909-110cf367-254a-441d-af38-c36a27c5be60.mp4
Case 2: Enable HW accel and Reduced motion should be checked
default https://user-images.githubusercontent.com/98358127/209826897-3eb81dc1-ddd5-4540-97df-93b68ffc28ee.mp4
Bugs filed:
Encountered:
Closed:
InvalidRelated: https://github.com/brave/brave-browser/issues/27558