Skip to content

fix(gui): center the wizard + show returning users only the new feature (26.06.01)#68

Merged
ErikChevalier merged 1 commit into
mainfrom
fix/wizard-centering
Jun 2, 2026
Merged

fix(gui): center the wizard + show returning users only the new feature (26.06.01)#68
ErikChevalier merged 1 commit into
mainfrom
fix/wizard-centering

Conversation

@ErikChevalier
Copy link
Copy Markdown
Contributor

What

Fixes two 26.06.00 wizard regressions and cuts patch 26.06.01.

  1. Off-center wizard. The setup wizard now centers over the main window on first show, with a screen-centered fallback when the parent is not yet mapped (the cause of the off-center open).
  2. "What's new" was the first thing existing users saw. After an update that bumps ONBOARDING_VERSION, a returning user now sees only the new feature's page (with its activation toggle) so they can review and enable it, instead of replaying welcome/privacy/browser. New installs get the personalization opt-in as the last setup step.

Also documents the convention in CONTRIBUTING: when a feature adds an opt-in setting users should review, add its wizard page and bump ONBOARDING_VERSION so it surfaces once to existing users.

Tests

ruff + format + mypy + 553 tests green, including a new test_returning_user_sees_only_the_new_feature_page.

🤖 Generated with Claude Code

…ature (26.06.01)

Fix a 26.06.00 regression where the setup wizard could open off-center, and
stop showing existing users the whole first-run flow after an update.

- onboarding_dialog.py: center the wizard over the main window on first
  show, falling back to the active screen when the parent is not yet mapped
  (the cause of the off-center open).
- A returning user (re-onboarded after an ONBOARDING_VERSION bump) now sees
  ONLY the new feature's page, with its activation toggle, so they can
  review and enable it, instead of replaying welcome/privacy/browser/etc.
  New installs get the personalization opt-in as the LAST setup step.
- Document the convention in CONTRIBUTING (bump ONBOARDING_VERSION + add the
  page when a feature adds an opt-in setting users should review), so future
  settings-bearing features surface to existing users at release.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@ErikChevalier ErikChevalier merged commit 3bf8e11 into main Jun 2, 2026
1 check passed
@ErikChevalier ErikChevalier deleted the fix/wizard-centering branch June 2, 2026 07:56
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant