Skip to content

Warn users about Connection Assist removing user-added bridges

Issue originally from: tpo/applications/tor-browser#41621 (comment 3024413).

Design estimate

User story

As a user of Connection Assist
I want to know when there's a risk of losing my current bridges
So that I can save them

Problem statement

If Tor Browser can't connect through Normal Bootstrap, the user is taken to the Connection Assist, which will offer to find bridges for them. However, it is possible that 1. the user already has bridges configured, but they hadn't been activated or 2. the user already has bridges configured and don't want to lose them. In the first case, we should remind the user to check if their bridges are active; in the second case, we need to make it clear for users that any bridges currently configured will be replaced by the new bridges found by Connection Asssit, and this might not be reversible.

Design scope

  • Remind users (in the Connection Assist) to check if their bridges are active and try Normal Bootstrapping again
  • Add a dialog for the user to confirm if they want to proceed with Auto-bootstrap and replace their bridges (if any)

Mockups on Figma

TBD

Acceptance criteria

Scenario 1: the current bridges aren't active

Given the "Use bridges" toggle is off
And Normal Bootstrap doesn't work
When Connection Assist is shown
Then it will remind the user to check if the "Use bridges" toggle is on

Scenario 2: the user already has bridges configured

Given there are bridges configured in the Connection settings already
And Normal Bootstrap doesn't work
When the user clicks on "Try a bridge" in the Connection Assist
Then a dialog appears to let the user know their current bridges will be replaced
And asks if they still want to proceed

Scenario 3: the user doesn't have bridges configured

Given there are no bridges configured in the Connection settings
And Normal Bootstrap doesn't work
When the user clicks on "Try a bridge" in the Connection Assist
Then Tor Browser proceeds to Auto-bootstrapping

Edited by Felicia