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 Brave
screen. 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 FreeTop 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
Top GitHub Comments
Removing
QA/Blocked
as required uplifts (https://github.com/brave/brave-core/pull/16321) to 1.47.x were doneVerification
In progress
usingand
Test Case 1: New onboarding UI -
brave://welcome
page upon Brave launch -PASSED
First run dialog
no longer displayedSet Brave as default browser
Confirmed new onboarding UI is shown -
brave://welcome
page withSet Brave as a default browser
andSkip
buttons as the first screenTest Case 2: Single browser and Single profile
Case 1: Second screen
Import Settings
will give users the ability to import and most recent used browser is set as a default -Edge
-Failed
Microsoft Edge
with a single profile withbookmarks
,extensions
,saved passwords
brave://welcome
page -Set Brave as default browser
Microsoft 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
Brave
as default and complete import fromMicrosoft Edge
-PASSED
brave://welcome
page -import settings
screenMicrosoft Edge
Import
buttonSetup complete
screen is displayedHelp improve Brave
screen is displayedBrave is your default browser
message is shownCase 3: Verify default settings in the
Help improve brave better
screen -PASSED
Help improve Brave better
screen is displayedSend diagnostic reports if you experience a crash or freeze
entry is checked as defaultShare completely private and anonymous product insights about what features are being used by Brave's users
entry is checked as defaultbrave://settings/privacy
link beneath theFinish
buttonbrave://settings/privacy
tab opened in a separate tabAutomatically send diagnostic reports
setting is enabledAllow privacy-preserving product analytics (P3A)
setting is enabledPrivacy Policy
linkbrave://settings/privacy
Help improve Brave better screen and click
Learn more` linksSend diagnostic reports if you experience a crash or freeze
redirected to:Share completely private and anonymous product insights about what features are being used by Brave's users
redirected to:Confirmed links on the page worked as expected
Case 4: Verify
Bookmarks
,Extensions
&Saved passwords
are successfully imported fromEdge
-FAILED
Help improve Brave
screen is displayedFinish
buttonbrave://bookmarks
saved passwords
shown inbrave://settings/passwords
history
shown 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 better
screen -PASSED
Set Brave as default browser
Microsoft Edge
Import
buttonSetup complete
page shownSend diagnostic reports if you experience a crash or freeze
entryShare completely private and anonymous product insights about what features are being used by Brave's users
entryFinish
brave://settings/privacy
in a new tab page####Confirmed
Automatically send diagnostic reports
setting is disabled ####ConfirmedAllow privacy-preserving product analytics (P3A)
setting is disabledCase 6: Do not set Brave as default & do not import -
PASSED
Skip
onbrave://welcome
screenSkip
onImport Settings
screenbrave://settings/getStarted
####Confirmed no profile data is imported. ####Confirmed
Brave://settings/getStarted
page shownMake default
buttonFiled: *https://github.com/brave/brave-browser/issues/27554
Case 7: Set Brave as default but do not import -
PASSED
Set Brave as default browser
onbrave://welcome
screenSkip
onImport Settings
screenbrave://settings/getStarted
Confirmed
Brave is your default browser
message shownCase 8: Do not set Brave as default but import Profile data -
PASSED
Skip
onbrave://welcome
screenImport
onImport Settings
screenMicrosoft Edge
Microsoft Edge Profile 2
Finish
brave://settings/getStarted
Confirmed new tab page shown with Profile data is imported (Bookmarks, Save passwords)
*
Brave://settings/getStarted
page should showMake default
button instead page showsBrave is your default browser
message.Case 9: Set Brave as default and skip import from onboarding UI, but proceed to import from
brave://settings/importData
-Failed
Prerequisite: Make sure Microsoft Edge as a default browser in `Windows
Set Brave as default browser
Skip
Finish
new tab
page opened as expectedBrave is your default browser
message shownbrave://settings/importData
Microsoft Edge
Profile 1Import
####Confirmed bookmarks are imported and shown in the
Bookmarks
side panel *Extensions are not imported - *https://github.com/brave/brave-browser/issues/27487 *ClickImport
button onImport bookmarks and settings
modal 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
-PASSED
Pre-requisite: Created 4 Profiles in Microsoft Edge with following:
Set Brave as default browser
Microsoft Edge
Import
Select profile to import
modalSelect All
to selectProfile 3
Back
Import Settings
screenImport
againImport profiles
Setup Complete
confirmation screen shownFinish
####Confirmed
Bookmarks
from Profile 1 and 2 are successfully imported ####ConfirmedSaved passwords
from 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 Settings
page -FAILED
Pre-requisites: Have import supported browsers installed
Chrome
,Chrome Beta
,Chrome Dev
,Chrome Canary
,Edge
,Firefox
,Opera
, andVivaldi
Set Brave as default browser
button onbrave://welcome
pageConfirmed
Chrome
,Chrome Canary
,Edge
,Firefox
,Opera
, andVivaldi
browsers listed*
Chrome Beta
andChrome Dev
are not listedFiled *https://github.com/brave/brave-browser/issues/27500
Case 2: Do not show all
Chrome channels
in theSelect profile to import
screen when Chrome(Stable)
selected inImport Settings
page -FAILED
Set Brave as default browser
button onbrave://welcome
pageChrome
Import
*Profiles from Chrome Beta and Dev channels also rendered. Should list only
Chrome
stable 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 -
PASSED
Firefox
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 browser
button onbrave://welcome
pageMozilla Firefox
onImport Settings
screenImport
Select All
Import profiles
Finish
Chrome Stable -
PASSED
Profile 1: Bookmarks, Saved passwords, Extensions Profile 2: Bookmarks Profile 3: No Data Profile 4: Bookmarks Profile 5: Bookmarks
Set Brave as default browser
Chrome
Import
Select All
and unselectChrome Person 2
Import profiles
Finish
####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 -
FAILED
Chrome 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 Beta
channel is not listedChrome Dev -
Failed
Profile 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 -
PASSED
1.46.144
Skip welcome tour
linkConfirmed new onboarding UI is not displayed.
Case 2: If previously onboarding is not completed, new onboarding UI is shown -
PASSED
1.46.144
Skip welcome tour
link 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 -
PASSED
new profile launch Brave with Disable HW accel flag
--disable-gpu
Confirmed 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:
Invalid
Related: https://github.com/brave/brave-browser/issues/27558